Unify API
保留 Anthropic SDK,调用所有模型。
把 Anthropic SDK 或 Claude Code 指向 AnyRouter,用 Messages 请求调用任意模型。
POST /api/v1/messages
diff --git a/app.py b/app.pyimport osimport anthropicclient = anthropic.Anthropic(removed: api_key=os.environ["ANTHROPIC_API_KEY"],added: base_url="https://anyrouter.dev/api",added: api_key=os.environ["ANYROUTER_API_KEY"],)msg = client.messages.create(removed: model="claude-sonnet-4-5",added: model="anyrouter/free", max_tokens=1024, messages=[{"role": "user", "content": "Hi"}],)for block in msg.content: if block.type == "text": print(block.text)API 访问从 Go 套餐开始($2/月,或向 Pool 捐赠一个 key 即免费)。anyrouter/free 在 Go 上免费;anyrouter/auto 使用额度。
返回了什么
上面的 cURL 标签页,于 2026-10-31 在生产环境用 Go 套餐 key 运行。只保留显示的字段,过长的值用 "…" 截断。
captured from prod
HTTP 200
x-anyrouter-model: poolside/laguna-s-2.1
x-anyrouter-provider-chain: hagiang
x-anyrouter-credential-source: platform
x-request-id: req_f8392517f9f140c08a2b1562
{
"type": "message",
"model": "poolside/laguna-s-2.1",
"content": [
{
"type": "text",
"text": "Hello! How can I help you today?"
}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 45,
"output_tokens": 10,
"cost": 0
}
}- x-anyrouter-model
- 实际回答的模型。anyrouter/free 等预设会在这里写出所选模型;指定模型 id 时则原样返回你的 id。
- x-anyrouter-provider-chain
- 按顺序尝试过的上游。这里只有一跳;某一跳失败时由下一跳回答,header 变为 a->b。
- x-anyrouter-credential-source
- 由谁的上游 key 付费:platform(平台)、own_byok(你自己的)或 pool(捐赠的 key)。
- x-request-id
- 联系支持时提供它,或在日志中查找该请求。
- usage.cost
- 本次请求的费用(美元),写在 body 里。免费模型为 0。
可选:控制路由
以下都不是必需的。每项只是同一请求上的一个字段或 header,均在生产环境实测。
指定任意模型 id
用目录里的 owner/model 代替预设。
"model": "nvidia/nemotron-3-nano-omni-30b-a3b-reasoning" → HTTP 200, provider-chain: kilo固定提供商
一个 header,按偏好顺序用逗号分隔。
X-AnyRouter-Provider: hagiang,kilo "model": "poolside/laguna-s-2.1" → HTTP 200, provider-chain: hagiang在 body 中排序提供商
与 OpenRouter 的 provider 对象相同。
"model": "nvidia/nemotron-3-ultra-550b-a55b" "provider": {"order": ["hagiang", "kilo"]} → HTTP 200, provider-chain: hagiang
已支持
- 流式输出(SSE)
- 工具 / 函数调用
- 扩展思考(thinking)
- 视觉模型支持图像输入
Decisions 模型
不是聊天。发送一个情境和带固定选项的问题,返回每个选项的概率。Decisions 在 Go 及以上套餐免费,Free 套餐可试用 5 次请求。
POST /api/v1/decisions
curl https://anyrouter.dev/api/v1/decisions \
-H "Authorization: Bearer $ANYROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "hal-x/thx-01", "state": "My card was charged twice",
"questions": {"team": {"type": "choice", "criteria": {"billing": "Payments", "tech": "API problems"}}}}'
# {"answers": {"team": {"type": "choice", "choice": "billing", "probabilities": {"billing": 0.97, "tech": 0.03}}}, "model": "hal-x/thx-01", "status": "completed"}