文字接口参考
Messages
POST /v1/messages,兼容 Anthropic Messages API,可接 Claude Code。
POST https://anyrouter.cc/v1/messages
x-api-key: sk-你的Key
anthropic-version: 2023-06-01
Content-Type: application/json请求和响应与 Anthropic Messages API 一致,Authorization: Bearer sk-… 也可以。Claude 5.5 系列只走这个协议;DeepSeek、豆包、GPT、Gemini 也能用它调用,网关负责转换。
基本调用
import anthropic
client = anthropic.Anthropic(base_url="https://anyrouter.cc", api_key="sk-你的Key")
msg = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=2000,
system="你是一名简洁的助手。",
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print("".join(block.text for block in msg.content if block.type == "text"))注意 base_url 不带 /v1,SDK 会自己拼上 /v1/messages。
常用参数
| 参数 | 说明 |
|---|---|
model | 必填 |
max_tokens | 必填,输出上限,含思考 token |
system | 系统提示,字符串或内容块数组 |
messages | user / assistant 交替的消息 |
thinking | {"type":"enabled","budget_tokens":N} 打开扩展思考(Claude)。其他模型的思考开关见模型参数 |
tools、tool_choice | 工具调用,写法同 Anthropic |
stream | true 时返回 message_start、content_block_delta 等 SSE 事件 |
cache_control | {"type":"ephemeral"} 标记提示缓存断点(Claude),命中部分按缓存价计费 |
思考内容
开启思考的模型会先返回 type: "thinking" 的内容块,再返回 type: "text"。DeepSeek、豆包默认开启思考,响应里同样会出现 thinking 块。只取答案时过滤出 text 块:
answer = "".join(b.text for b in msg.content if b.type == "text")提示缓存(Claude)
长系统提示、工具定义、长文档重复使用时,在要缓存的块末尾加 cache_control:
system=[{"type": "text", "text": 很长的说明, "cache_control": {"type": "ephemeral"}}]首次写入按「缓存写入」价计费,之后命中按「缓存读取」价,具体价格见模型与价格。
接入 Claude Code
export ANTHROPIC_BASE_URL=https://anyrouter.cc
export ANTHROPIC_AUTH_TOKEN=sk-你的Key
export ANTHROPIC_MODEL=claude-sonnet-5-5
export ANTHROPIC_SMALL_FAST_MODEL=claude-haiku-5-5
claudeClaude 模型需要 Key 开通 Claude 权限;没有开通时会返回「无可用渠道」。也可以把 ANTHROPIC_MODEL 设成 deepseek-flash 等模型,用 Claude Code 驱动其他模型。