API 接口基础

本页只列已确认的接入示例，不是上游 API 全量规格；具体能力取决于协议、模型和密钥分组。

协议	Base URL	示例端点
OpenAI 兼容	https://api.nekocloud.vip/v1	POST /chat/completions 或 POST /responses
Anthropic 兼容	https://api.nekocloud.vip	由 Anthropic 客户端 SDK 使用其接口路径
Gemini 兼容	https://api.nekocloud.vip/v1beta	由 Gemini 客户端 SDK 使用其接口路径

鉴权与首个请求

在主站创建 API 密钥。OpenAI 兼容请求使用 Authorization: Bearer <本人密钥>；不要把真实密钥放进代码仓库、URL、截图或工单。

curl https://api.nekocloud.vip/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"当前密钥可用的模型名","messages":[{"role":"user","content":"你好"}]}'

将示例模型换成当前密钥分组可用的模型。Codex 应按 Responses 接入配置，不要假设所有模型均支持 Chat Completions。价格与单位看模型广场，逐笔实扣以主站「使用记录」为准。

流式响应与错误

支持流式聊天的客户端可在请求体加 "stream": true；逐段消费事件流，不要按单个 JSON 读取；连接中断时不能假定完整响应已到达。

状态	首先检查
401	是否实际发送 Authorization，密钥是否有效
403	余额、账号状态或安全策略；结合响应错误码判定
429	降低并发，尊重响应给出的重试提示，退避重试
模型不可用	模型名及密钥所属分组的权限

不要盲目重试非幂等请求：上游可能已经收到请求。持续异常时记录时间、模型、状态码与请求 ID（如有），联系客服前脱敏密钥和输入内容。