接口与鉴权

请求地址

API 根地址为 https://api.cocoapi.top。所有请求都应使用 HTTPS，避免在传输过程中泄露密钥和内容。

操作	方法	路径	说明
查询模型	GET	/v1/models	需要有效密钥，列表受权限影响
文本对话	POST	/v1/chat/completions	适用于支持 Chat Completions 的模型
Claude 对话	POST	/v1/messages	适用于支持 Messages 的模型

这里只列出本版文档的接入范围。不要把某个上游厂商的全部 API 目录当作本站已开放接口列表。

鉴权方式

Chat Completions 和模型列表使用 Bearer 鉴权：

Authorization: Bearer YOUR_COCO_API_KEY

Claude Messages 示例使用协议对应的请求头：

x-api-key: YOUR_COCO_API_KEY
anthropic-version: 2023-06-01
Content-Type: application/json

YOUR_COCO_API_KEY 代表本站密钥，不是任何厂商官网密钥。不要把密钥放在 URL 查询参数中，也不要把请求头记录到公开日志。

请求体与响应

提交 JSON 请求时使用 Content-Type: application/json。model 必须匹配当前密钥分组有权限调用的模型标识。先从少量基础字段开始，避免一次加入大量未经验证的可选参数。

Chat Completions、Messages 和流式响应的结构不同，不能用同一套 choices[0] 解析逻辑处理所有协议。查看Chat Completions、Claude Messages及流式输出。

错误与请求编号

客户端应同时检查 HTTP 状态码和响应体。错误内容可能由网关或上游返回，字段不保证在所有情况下完全一致；代理故障也可能返回 HTML 而不是 JSON。

保留响应中的请求编号。本站响应可能提供 X-Oneapi-Request-Id，错误文本也可能含 request id。不要只依赖某一个 SDK 的官方请求编号属性，否则可能漏掉网关的诊断信息。

超时与重试

为连接建立和整个请求分别设置合理超时。超时不一定表示服务端未执行，自动重试生成请求可能带来额外费用。

• 400、401、403：先修正配置或权限，不应原样循环重试。
• 429：降低并发，若提供 Retry-After 则参考它等待。
• 临时网络故障或 5xx：检查状态后进行有限次数、带间隔的重试。
• 流式请求已经输出部分内容：不要自动拼接另一条重试请求的结果。

本站不在本文中承诺生成请求具有幂等去重能力。重要任务应由应用自行记录请求状态和结果。

验证边界

HTTPS 可访问、未带密钥返回 401，都只能确认网络入口或鉴权路由，不能证明模型已成功生成。完整验证还需要有效密钥、目标分组、实际模型响应及消费日志。