常见问题

只列跨应用的通用问题。具体应用的对接细节见各应用接入页面。

鉴权与 Key

我的 Key 泄露了怎么办

立即到控制台停用或重置该 Key。重置后旧密钥立即失效；随后到调用日志检查是否有可疑请求记录，并更新所有使用该 Key 的服务。API Key 不支持删除。

一个账户可以创建多少把 Key

未限制单账户的 Key 数量。建议为每个使用场景（不同应用、不同环境、不同团队成员）创建独立 Key，便于追踪用量与按需吊销。

同一个分组下创建多把 Key 有什么区别

Key 本身只是凭证。统计粒度细到单 Key，权限与计费倍率取自所属分组。

模型与协议

我应该走 OpenAI 兼容协议还是 Anthropic 协议调用 Claude

如果你的客户端是 Claude Code、Cline、Roo Code、Anthropic SDK 等原生支持 Anthropic 协议的工具，走 Anthropic 协议（https://api.tokenbay.com/v1/messages）。这条路径能完整使用 prompt caching、tool result 等 Anthropic 专属字段。

其他情况（应用只支持 OpenAI 兼容协议），走 /v1/chat/completions 也能调用 Claude，但部分高级特性会丢失。

控制台说有某模型，但调用报 404

/v1/models 的公开返回范围仍在确认中。当前请以线上 Models 页面和控制台可见模型为准；如果工具自动拉取不到模型，可先手动填写模型 ID，并检查 API Key、余额和额度规则。

上游某个模型涨价了，TokenBay 倍率会同步吗

会。TokenBay 倍率反映上游成本，调整有提前公告。生效后旧请求按下单时倍率结算，新请求按新倍率。

网络与代理

国内访问 `api.tokenbay.com` 慢

TokenBay 节点分布与当前的 CDN 配置见状态页。短期内可在客户端侧加一层本地反向代理改善连通性。不要自己改 DNS 把请求指向不可信节点——会拦截到你的 API Key。

我用 HTTP 代理（如 mitmproxy）抓 TLS 流量，请求失败

部分 SDK 在检测到自签证书时会拒绝连接。把代理的根证书加入操作系统信任链，或在 SDK 配置中显式信任。

计费

失败请求会扣费吗

详见监控与排障 / 失败请求如何计费。简而言之：网关层拒绝、上游返回错误，均不扣费；流式响应中途断开按已生成 tokens 计费。

我的实际消耗与预期不符

到调用日志看单次请求明细。常见原因：

流式响应的客户端没正确处理 usage 字段，统计漏算
自动补全类应用（Continue autocomplete、Copilot 风格扩展）按键触发，请求量远高于聊天场景
prompt caching 未生效（缓存窗口过期、模型不支持），缓存倍率退化为输入倍率

文档与反馈

我想接的工具不在文档里

只要支持自定义 OpenAI / Anthropic 兼容 endpoint 即可对接。直接填 https://api.tokenbay.com/v1（OpenAI）或 https://api.tokenbay.com（Anthropic），Key 填 sk-...。需要补充文档欢迎反馈。

报告错误 / 提建议的渠道

到控制台提交工单，或在文档站对应页面底部反馈。安全相关问题请走专属渠道，不要在公开 issue 里贴 API Key 或日志原文。