TheRouter 弃用 /v1/anthropic/* 路径：2026 年 9 月 3 日前迁移到 /v1/messages

如果你在调用 TheRouter 的 Anthropic 格式入口 /v1/anthropic/messages 或 /v1/anthropic/messages/count_tokens，请注意截止日期：2026 年 9 月 3 日。 当天旧路径将被移除。规范路径 /v1/messages 和 /v1/messages/count_tokens 现已可用，行为完全一致，不受影响。

这是一次路径重命名，不是行为变更：请求格式、响应格式、流式输出、计费、API key 全部不变。

变更内容与时间线

路径映射：

为什么是 /v1/messages

/v1/messages 是 Anthropic 官方 API 路径 —— 所有 Anthropic 官方 SDK 都会在 base URL 后自动拼接它。/v1/anthropic/ 前缀是 TheRouter 早期的自创约定， 官方 SDK 不识别，必须手动拼 URL。统一到官方路径后，任何 Anthropic SDK 指向 TheRouter 都只需改一行，零路径配置。

如何迁移

使用 Anthropic SDK 的，把 base URL 设为 TheRouter 根地址，不带任何路径后缀：

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.therouter.ai",  # SDK 自动拼接 /v1/messages
    api_key="sk-tr-YOUR_KEY",
)

message = client.messages.create(
    model="anthropic/claude-sonnet-4.5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)

直接发 HTTP 请求的，替换路径：

- POST https://api.therouter.ai/v1/anthropic/messages
+ POST https://api.therouter.ai/v1/messages

规范路径同样支持 Authorization: Bearer 和 x-api-key 两种鉴权头，与之前 完全一致。

如何确认自己是否受影响

检查当前集成的任意一个响应：如果带 Deprecation: true 响应头，说明你在调用 旧路径；没有这个头，说明你已经在规范路径上，无需任何改动。

命令行快速检查：

curl -si https://api.therouter.ai/v1/anthropic/messages \
  -H "x-api-key: $THEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"anthropic/claude-sonnet-4.5","max_tokens":1,"messages":[{"role":"user","content":"ping"}]}' \
  | grep -i -E "^(deprecation|sunset):"

TheRouter 用户该做什么

• 在代码和配置里全局搜索 /v1/anthropic。 任何匹配 —— SDK base URL、 原生 HTTP 调用、环境变量、基础设施代码 —— 都需要在 9 月 3 日前完成这一行 修改。
• 优先用 SDK base-URL 形式。 base_url="https://api.therouter.ai" 向前 兼容；手工拼路径是迁移最容易遗漏的地方。
• 不要等 D-15 联络。 8 月 19 日起我们会逐一联系仍在旧路径上的租户 —— 在那之前完成迁移，你这边就少一次运维打断。