Claude · Messages 原生协议

Anthropic SDK、Claude Code 与原生 Messages 接入。

POST/v1/messages
https://api.hanrouter.ai/v1管理 API Key

地址与认证

OpenAI 兼容客户端的 Base URL 为 https://api.hanrouter.ai/v1,请求头为 Authorization: Bearer $HANROUTER_API_KEY。不要重复拼接 /v1。所有厂商都使用本站密钥,不需要向客户端填写上游厂商密钥。

Anthropic SDK 与 Claude Code 的 Base URL 使用 https://api.hanrouter.ai(不含 /v1),由客户端拼接 /v1/messages。Google 模型优先使用本站 OpenAI 兼容接口。

协议与权限

使用 x-api-key 与 anthropic-version: 2023-06-01。系统提示放在顶层 system,max_tokens 必填。响应读取 content 中的 text 块。能否调用取决于 Key 分组及渠道的 Messages 支持。Claude Code 配置见帮助中心。

请求参数

model
必填 string:当前 Key 可用的准确模型 ID。
messages
必填 array:role 与 content 组成的消息列表。
max_tokens
Messages 必填 integer:最大输出 Token。
stream
可选 boolean:启用 SSE 增量输出,默认 false。

请求示例

示例采用当前目录中的模型 ID。实际可调用范围取决于 API Key 的分组权限,请先查询 GET /v1/models。

cURL
curl -X POST "https://api.hanrouter.ai/v1/messages" \
  -H "x-api-key: $HANROUTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "your-model-id",
  "max_tokens": 512,
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ]
}'

响应示例

JSON · 结构示例
{
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello!"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 8,
    "output_tokens": 3
  }
}