Anthropic Messages

接口行为

使用 Messages 部署。原生客户端发送 anthropic-version: 2023-06-01，XHub 也接受 x-api-key 携带密钥。工具调用与结果是内容块。

接口与认证

POST /v1/messages

使用 XHub API 密钥：Authorization: Bearer 。不要把供应商密钥当作网关密钥。

Base URL 使用调试台显示的网关根地址，不额外追加 /v1；实际请求使用上面的完整接口路径。

请求示例

curl "$XHUB_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $XHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_NAME","max_tokens":256,"messages":[{"role":"user","content":"Hello, introduce yourself."}]}'

请求参数

字段	类型	说明
model	string · required	公开模型名，部署必须支持此协议。
max_tokens	integer · required	最大输出 Token。
messages	object[] · required	user/assistant 内容块。
system	string or array	顶层系统指令。
tools / stream	array / boolean	Anthropic 工具定义 / 事件流。

成功响应

{
  "id": "msg-example",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello!"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 10,
    "output_tokens": 5
  }
}

字段	类型
id	string
type	string
role	string
content	object[]
content[].type	string
content[].text	string
stop_reason	string
usage	object
usage.input_tokens	number
usage.output_tokens	number

错误与排查

HTTP	说明
400	请求无效，请检查 JSON、参数和查询。
401	XHub 凭据缺失或无效。
403	权限拒绝，请检查模型范围或策略。
429	超过限制，请检查响应详情与 Retry-After。