常见问题
接入方式、模型范围、计费记录与常用工具配置的集中解答。
This content is not available in your language yet.
接入时需要修改什么？ 创建与目标协议匹配的 API Key，把客户端的 Base URL 与密钥替换为网关提供的值，再选择该分组开放的模型。
支持哪些协议和开发工具？ 提供 OpenAI、Anthropic 与 Responses API 的接入示例，并覆盖 Claude Code、Codex、OpenCode 及常用 SDK。实际可用模型由密钥所属分组决定。
Base URL 到底带不带 /v1？
| 场景 | 填什么 |
|---|---|
| OpenAI 兼容（SDK、Codex、OpenCode、Cursor、Cline、Cherry Studio） | https://ai.roibest.com/v1 |
| Anthropic 兼容（Anthropic SDK、Claude Code） | https://ai.roibest.com |
| Gemini 兼容 | https://ai.roibest.com/v1beta |
CC Switch 怎么接入？ 进入 API Keys 页面，在目标密钥旁点击「导入到 CC Switch」。导入链接由浏览器生成，CC Switch 会在写入配置前展示确认信息。详见 CC Switch。
在哪里查看可用模型和价格？
模型广场展示当前模型、服务分组与参考价格；实际可调用范围以账户与密钥权限为准。也可以用密钥请求 /v1/models。
模型广场打不开。 公开模型广场未开放时，登录控制台查看账户可用范围，或联系管理员确认模型与价格。
换模型要改代码吗？
同一协议下只改请求里的 model 参数。
如何核对 Token 和费用？ 用量记录按请求展示模型、分组、输入输出及缓存 Token、计费方式、费用和延迟，错误请求可在错误记录中单独筛选。详见计费与用量核对。
余额会过期吗？ 不会。按实际用量计费，未消耗部分持续可用。
401，提示令牌无效。 密钥拼写有误、已过期或已被禁用。
403，提示 IP 不在允许列表中。 密钥配置了 IP 允许列表，当前出口 IP 不在其中。
404 或 model_not_found。
模型名拼错，或该模型不在密钥所属分组的开放范围内。
429。 触发了 IP 级或账号级限流，见限流与重试。
完整的错误码对照见 API 参考的错误码页。