Claude Messages

此页给出 Messages 协议的文本接入模板。使用前确认所选分组、模型和渠道支持 /v1/messages；不要只因模型名称包含 Claude 就假定所有参数都兼容。

端点与请求头

http

POST https://api.cocoapi.top/v1/messages
x-api-key: YOUR_COCO_API_KEY
anthropic-version: 2023-06-01
Content-Type: application/json

请求示例

先设置 COCO_API_KEY，并将 YOUR_MODEL_ID 替换成本站支持 Messages 的模型。此请求可能收费。

curl --connect-timeout 10 --max-time 120 --fail-with-body \
  https://api.cocoapi.top/v1/messages \
  -H "x-api-key: ${COCO_API_KEY}" \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "YOUR_MODEL_ID",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "Reply with OK only."}]
  }'

参数区别

Messages 请求需要 max_tokens 指定输出上限。多轮对话使用 user / assistant 消息；需要系统提示时，使用协议对应的顶层 system 字段，而不是直接照搬 Chat Completions 的消息角色写法。

额外的 thinking、tools、缓存和版本试验参数需要单独确认兼容性。模型或分组不支持时，不要靠不断增大额度或更换密钥来重试同一错误。

读取结果

Messages 的文本通常位于 content 内容块数组中，需筛选 type 为 text 的块。它不是 Chat Completions 的 choices 结构。

响应示意：

json

{
  "id": "example-message-id",
  "type": "message",
  "role": "assistant",
  "model": "YOUR_MODEL_ID",
  "content": [{"type": "text", "text": "OK"}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 10, "output_tokens": 1}
}

示例不代表真实响应的完整字段，也不证明上游实际模型身份。费用以本站使用日志为准。

流式接入

当渠道支持时，可设置 stream: true。Messages 使用不同类型的事件，不能直接用 Chat Completions 的 choices[].delta 解析器处理。先使用可信 SDK 或适配器完成基本事件处理，再验证错误、结束事件和断线行为。

Claude Messages ​

端点与请求头 ​

请求示例 ​

参数区别 ​