创建消息

Anthropic Messages API：Claude 模型专用，Base URL 不带 /v1，Anthropic SDK 与 Claude Code 直接可用。

POST/v1/messages

Claude 模型走 Anthropic 协议。SDK 的 Base URL 填 https://api.hop-base.com（不带 /v1），请求路径仍是 /v1/messages；另支持 POST /v1/messages/count_tokens。

下表只列网关会补值或特别处理的部分；其余 Messages API 字段原样转发，取值范围按 Anthropic 官方规格。Claude 密钥调 OpenAI 协议路径会返回 404「当前平台不支持该 API 路径」。

创建消息

curl https://api.hop-base.com/v1/messages \
  -H "x-api-key: $HOPBASE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

200application/json

{
  "id": "msg_EXAMPLE",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5",
  "content": [
    {
      "type": "text",
      "text": "你好！有什么可以帮你？"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 9,
    "output_tokens": 14,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

请求头

Authorization:可选string

Bearer sk-…；也可改用 x-api-key: sk-…，二者任选其一

anthropic-version:可选string

SDK 会自动带上，原样转发，例如 2023-06-01

anthropic-beta:可选string

Beta 功能开关，原样转发

请求体参数JSON

model:必填string

当前密钥分组内的 Claude 模型 ID；分组不包含该模型时返回 404 model_not_found

max_tokens:可选integer

网关不设上限，最大值按模型官方规格。官方 API 要求必填，HopBase 缺省时补为 4096：长输出会在 4096 处截断（stop_reason: "max_tokens"），请显式设置

默认4096

messages:必填array of object

按 Anthropic 官方格式，原样转发

数量≥ 1 项

system:可选string 或 array

系统提示词，原样转发

stream:可选boolean

true 返回 Anthropic SSE 事件流

默认false

tools:可选array of object

Anthropic 工具定义（name、description、input_schema），原样转发

thinking:可选object

扩展思考配置，原样转发，取值按 Anthropic 官方规格

temperature:可选number

原样转发，范围按 Anthropic 官方规格

200成功。非流式为 message JSON；stream: true 时为 Anthropic SSE

id:可选string

消息 ID

type:可选"message"

role:可选"assistant"

model:可选string

模型 ID

content:可选array of object

内容块

stop_reason:可选string

end_turn / max_tokens / tool_use / stop_sequence

usage:可选object

Token 用量

错误

400Anthropic 结构：{"type":"error","error":{"type":"invalid_request_error","message":"…"}}，没有 code。密钥校验阶段的错误（401、402、403）仍为 OpenAI 结构

401没带密钥、密钥无效或已过期（missing_api_key / invalid_api_key / api_key_expired）

402余额或密钥 / 成员 / 部门额度用完（insufficient_quota）

404模型不在这把密钥的分组里（model_not_found），或路径不属于该分组（route_not_found）

413请求体超过 60 MB（request_too_large）

429帐户或密钥并发已达上限（user_concurrency_limit / apikey_concurrency_limit），带 Retry-After

请求头

请求体参数JSON

返回

错误

相关页面