Chat Completions

通过消息列表发起文本对话，适用于在本站支持此协议的模型。接口格式兼容不意味着所有官方扩展能力均可用。

端点

POST https://api.cocoapi.top/v1/chat/completions
Authorization: Bearer YOUR_COCO_API_KEY
Content-Type: application/json

基础字段

字段	类型	说明
model	string	本站可用模型的精确标识，必填
messages	array	对话消息列表，必填；最小测试可只包含一条 user 消息
messages[].role	string	消息角色；简单测试使用 user
messages[].content	string	本文示例使用纯文本
stream	boolean	是否流式输出，本文示例设为 false
max_tokens	integer	可选输出上限；仅在所选模型支持时使用

不同模型可能使用不同的输出上限参数，或对 temperature、工具调用等字段有额外限制。不要同时传入语义冲突的上限参数。

请求示例

先设置 COCO_API_KEY，并替换 YOUR_MODEL_ID。执行生成请求可能收费。

curl --connect-timeout 10 --max-time 120 --fail-with-body \
  https://api.cocoapi.top/v1/chat/completions \
  -H "Authorization: Bearer ${COCO_API_KEY}" \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "Reply with OK only."}],
    "max_tokens": 32,
    "stream": false
  }'

响应示意

下面为最小格式示意，Token 数量和内容并非实测结果：

{
  "id": "example-completion-id",
  "object": "chat.completion",
  "model": "YOUR_MODEL_ID",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "OK"},
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 10, "completion_tokens": 1, "total_tokens": 11}
}

简单文本可从 choices[0].message.content 读取。若启用了工具调用等能力，content 可能为空，需要按实际协议处理工具字段；不可直接把空文本当作请求失败。

usage 用于查看用量，不是人民币账单。最终费用还与分组、缓存和计费规则相关，见余额与计费。

兼容性检查

先测纯文本，再添加系统提示、工具调用或图片。某个参数在厂商官方文档出现，不代表本站每条渠道都支持。遇到参数不支持时，减少为最小请求，并保留错误详情。

协议字段参考：OpenAI Chat Completions 官方文档。本站的可用模型、权限与计费由 COCO API 单独决定。