Anthropic 接口协议

了解通过球球 Token 调用 Anthropic 兼容接口时的适用场景、鉴权、路径和请求格式。

Anthropic 兼容协议适用于 Claude Code、Claude Desktop、Cherry Studio 的 Anthropic 服务商，以及需要直接调用 Messages 接口的程序。

如果客户端让你填写 Claude、Anthropic 或 Gateway Base URL，请填写根地址，不要手动追加 /v1。如果你自己发起 HTTP 请求，请在根地址后访问 Messages 路径。

基础地址与路径

Base URL：https://api.qiuqiutoken.net
请求路径：/v1/messages
完整请求地址：https://api.qiuqiutoken.net/v1/messages

POST/v1/messages

鉴权

使用控制台创建的 API Token。为 Claude、Anthropic 客户端或 Claude 模型创建令牌时，请选择对应分组；不要保留 default 分组。

直接发起 HTTP 请求时，请带上以下请求头：

content-type: application/json
x-api-key: sk-your-token
anthropic-version: 2023-06-01

Claude Desktop 的第三方推理配置不是手写请求头；在客户端里将 Gateway auth scheme 选择为 bearer。

最小请求

将 <model-id> 替换为模型广场中的可用 Claude 模型名称，将 sk-your-token 替换为对应分组的 API Token。

curl https://api.qiuqiutoken.net/v1/messages \
-H "content-type: application/json" \
-H "x-api-key: sk-your-token" \
-H "anthropic-version: 2023-06-01" \
-d '{
  "model": "<model-id>",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "你好" }
  ]
}'

注意事项

切换线路时只替换 Base URL，API Token、模型名称和令牌分组保持不变。
模型名称必须与模型广场中的可用名称一致；出现模型 404 时，优先核对模型名和令牌分组。