❓ 常见问题
这里整理 api2cn.com 使用过程中最常见的问题与解答。
💡 问题解答
1. 为什么我的客户端请求失败？
请优先检查以下三项：
- Base URL：是否填写为
[https://api.api2cn.com/v1](https://api.api2cn.com/v1)。 - API Key：是否输入正确（确认未包含空格或换行）。
- 账户额度：确认账户内是否有可用余额或有效订阅额度。
2. 余额和订阅哪个先扣？
系统会根据账户计费偏好和可用额度选择扣费来源。通常情况下，如果有可用订阅，将优先消耗订阅额度。
3. 支持哪些充值方式？
- 在线充值：支持微信支付、支付宝、Visa 等银行卡及加密货币
- 兑换码充值：支持使用卡密/兑换码进行充值。
提示：实际可用的支付方式可能会因地区、币种、设备和浏览器有所不同。
4. 支持哪些客户端？
支持所有能够配置 OpenAI Compatible Base URL、API Key 和 模型 ID 的客户端，包括：
- 桌面端与 Web 端：Cursor、Cherry Studio、Chatbox、Open WebUI 等。
- CLI 与 SDK：Claude Code、Codex CLI、CC Switch 以及常见 SDK。
注意：某些客户端的专用代码补全（Completion）或内置 Agent 功能可能仍使用其官方服务。
5. 接入 API2CN.COM 需要退出工具原来的账号吗？
通常不需要。
- 工具本身账号：负责同步、订阅或编辑器固有功能。
- API2CN.COM API Key：负责处理自定义模型请求。
只需在模型或 Provider 设置中选择 API2CN.COM 即可；只有当客户端明确要求重新认证时才需要退出。
6. Base URL 到底填哪个？
根据不同客户端的需求填写：
- OpenAI Compatible 客户端：填写
[https://api.api2cn.com/v1](https://api.api2cn.com/v1) - Claude Code（Anthropic 网关变量）：填写
[https://api.api2cn.com](https://api.api2cn.com) - 完整 Endpoint：只有字段明确要求填写完整接口地址时，才追加
/chat/completions。
7. 为什么模型列表为空，但 Key 没报错？
部分客户端不会自动读取兼容接口的模型列表，或者会过滤不认识的模型。
解决方法：请从 api.api2cn.com 控制台复制完整的模型 ID，并在客户端中手动添加。
8. 怎样确认请求确实走了 api.api2cn.com？
- 为该工具专门创建一个 API Key。
- 使用该 Key 发送一条短消息进行测试。
- 登录 api.api2cn.com 控制台，在 用量日志 中按时间与 Key 核对请求记录。
注意：仅看客户端界面显示的模型名称并不可靠，请以控制台日志为准。
9. 怎样恢复工具原来的官方模型？
- 在模型选择器中切回内置 Provider，并停用自定义 Base URL 或 api.api2cn.com Provider。
- CLI 用户：删除或取消对应环境变量。
- 重启终端或客户端软件以生效。