API 参考

Anthropic Messages

使用 Anthropic Messages 兼容格式。

Anthropic Messages 兼容接口

该端点用于需要 Anthropic Messages 请求结构的客户端和迁移场景。

POST /v1/messages

认证仍使用 Authorization: Bearer <API_KEY>。选择的分组和模型必须支持 Anthropic Messages 兼容路由。

最小请求

bash

curl --fail-with-body https://suoxie.codes/v1/messages \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model":"<MODEL>","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK"}]}'

同一个请求体展开如下：

json

{
  "model": "<MODEL>",
  "max_tokens": 256,
  "messages": [{ "role": "user", "content": "Reply with OK" }]
}

请求字段

字段	类型	必填	说明
`model`	string	是	当前 Key 可用的精确模型 ID
`max_tokens`	integer	是	本次最多生成的 Token；先使用较小值验证
`messages`	array	是	按顺序排列的对话消息
`system`	string 或内容数组	否	系统级说明，和 `messages` 分开
`stream`	boolean	否	是否返回流式事件

成功响应

json

{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "<MODEL>",
  "content": [
    {
      "type": "text",
      "text": "OK"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 10,
    "output_tokens": 2
  }
}

ID、用量和停止原因以实际响应为准。客户端应按 content[].type 读取内容，不能假设所有内容块都是纯文本。

与 Responses 的区别

Messages 使用 messages 和 max_tokens；Responses 使用 input 和 output。
不要把两种请求字段混在同一个请求体中。
新服务端集成优先使用 Responses API；只有客户端明确要求 Messages 格式时使用本页端点。

常见错误

400 通常表示消息结构或必填字段错误；401 是认证问题；403 多为分组/模型权限；429 需要遵守 Retry-After 并检查额度。先用 /v1/models 验证同一 Key，再缩减到本页最小请求。

下一步

完成非流式文本请求后再启用流式、系统提示或工具能力，并在 Key 用量核对请求类型。

Anthropic Messages 兼容接口 ​

最小请求 ​

请求字段 ​

成功响应 ​

与 Responses 的区别 ​

常见错误 ​