Claude · Messages 原生协议
Anthropic SDK、Claude Code 与原生 Messages 接入。
POST
/v1/messageshttps://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
}
}