玄枢API

Messages API

Claude Messages 与 token 计数公开兼容端点。

最后验证日期: 2026-07-23

连接与鉴权

统一 OpenAI 兼容 Base URL: https://www.xuanshuapi.com/v1

OpenAI 兼容接口使用 Authorization: Bearer <YOUR_API_KEY>；Claude Messages 也支持 x-api-key: <YOUR_API_KEY>；Gemini v1beta 使用 x-goog-api-key: <YOUR_API_KEY>。

Messages API

POST /v1/messages 支持普通和流式响应；POST /v1/messages/count_tokens 用于请求前估算 token。

具体 Claude 模型与工具能力以当前控制台配置为准。

请求体与调用

使用 Messages 请求体发送 system/user 内容；max_tokens 必填并可选择 stream。

curl https://www.xuanshuapi.com/v1/messages \
  -H "x-api-key: <YOUR_API_KEY>" -H "content-type: application/json" \
  -d '{"model":"<MODEL_FROM_MODELS>","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK"}],"stream":false}'

响应与流式行为

非流式响应在 content 数组返回文本块与 usage；stream=true 时按 SSE 事件增量返回。

HTTP 200
{"type":"message","role":"assistant","content":[{"type":"text","text":"OK"}],"usage":{"input_tokens":12,"output_tokens":1}}

关键参数

参数	说明
model	从 Models 或控制台取得的 Claude 模型 ID。
messages	按顺序提供角色与内容。
max_tokens	输出 token 上限。
stream	启用 SSE 增量事件。

典型故障

400 检查请求体和 max_tokens；401 检查 Key；429/5xx 才考虑有限退避。

HTTP 400  # invalid body or unsupported parameter
HTTP 401  # missing or invalid API key
HTTP 429  # quota or rate limit
HTTP 5xx  # recoverable service failure

下一步

可用模型、倍率、配额及部分高级能力动态依赖当前 Key 与控制台配置。