API 参考

Messages(Anthropic 格式)

POST/v1/messages

Anthropic 原生线格式,用同一把 Bearer 密钥。Claude Code 和官方 anthropic SDK 只改 base URL 就能用——没有适配层,不做格式转换。

#请求参数

  • modelstring必填

    Claude 模型 ID,见模型页,例如 claude-opus-5-5。

  • max_tokensinteger必填

    Anthropic 格式要求必填——输出硬上限。

  • messagesarray必填

    Anthropic 风格轮次:{role: user|assistant, content}。

  • systemstring可选

    系统提示词——这里是顶层字段,不是 message 角色。

  • streamboolean可选

    流式返回 Anthropic 原生 SSE 事件(message_start、content_block_delta……)。

  • temperaturenumber可选

    Anthropic 标度下 0 到 1。

  • toolsarray可选

    Anthropic 工具定义;tool_use 块随 content 返回。

anthropic-version 头

按官方 API 要求带上 anthropic-version: 2023-06-01。Authorization: Bearer 可用;原版 Anthropic SDK 发的 x-api-key 也接受。

#相关错误码

  • 400 invalid_request_error请求体格式错误,或该模型不支持某个参数。
  • 401Bearer 令牌无效或缺失。这条路径不带 error.code,请按状态码判断。
  • 402 insufficient_user_quota钱包余额不足以覆盖预扣估算。
  • 429密钥级限流。响应体为空,按 Retry-After 等待。若 429 带有 insufficient_user_quota,那是每日消费上限,不是限流。
  • 503 model_not_found模型名不存在,或当前没有健康渠道可以服务它。

完整错误码表 →

#请求示例

curl https://www.aisplice.store/v1/messages \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Say hello."}]
  }'

#响应

response.json
{
  "id": "msg_…",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5-5",
  "content": [{"type": "text", "text": "Hello!"}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 10, "output_tokens": 5}
}

还是没解决?

把请求 ID 或报错信息发给我们,我们来查。