常见问题

接入

base_url 到底填什么?

• OpenAI SDK / OpenAI 兼容客户端:https://api.tokrouter.dev/v1
• Anthropic SDK:https://api.tokrouter.dev(SDK 自己拼 /v1/messages)
• google-genai:https://api.tokrouter.dev

填错最常见的两种:OpenAI 客户端漏了 /v1,Anthropic 客户端多写了 /v1。

需要安装 TokRouter 的 SDK 吗?

不需要。网关实现厂商原生协议,用官方 SDK 改 base_url 即可。

401 怎么排查?

1. 头里有没有 Bearer 前缀(OpenAI 协议)
2. 令牌是否被删除、过期或禁用
3. 是不是把账号密码当成了 API Key

计费

失败请求收费吗?

不收费。只有真正返回了 token 的请求才计入用量。

为什么输出价比输入价高这么多?

输出 token 的生成成本显著高于输入,这是上游厂商的定价结构,网关按原样分项披露。

余额用完后会怎样?

硬停:所有请求返回额度不足错误,充值后立即恢复。令牌级的额度上限只影响该令牌。

协议

能用 OpenAI SDK 调 Claude 吗?

可以。把 model 设成 Claude 的模型 id 即可,网关负责映射到 Anthropic 协议。

能用 Claude Code 吗?

可以。设 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 两个环境变量,见Claude Code。

支持流式吗?

支持。四种入站协议都走 SSE;唯一例外是 /v1/systemone。

模型

为什么文档里的模型数量和 /v1/models 不一致?

文档页是构建期快照,/v1/models 是运行时真值。以 /v1/models 为可用性依据。

模型 id 里的点号和连字符有区别吗?

有。claude-sonnet-5.5 与 claude-sonnet-5-5 是网关里两个不同的 id(前者是网关命名,后者是厂商规范命名)。 不确定时以模型页的写法为准。