常见问题

接入与配置

Base URL 到底要不要加 /v1？

取决于工具会不会自己拼接路径：

• 填到 /v1：OpenAI SDK、Cursor、Codex CLI、LangChain、Dify
• 不加 /v1：Claude Code、Anthropic SDK、Cherry Studio、Gemini SDK

填错一般会返回 404。详见 客户端接入总览。

提示模型不存在？

模型名必须与 模型广场 中的完全一致（区分大小写）。也可以用 GET /v1/models 查看当前密钥能用的模型。

返回 524 或长请求中途断开？

非流式请求超过约 100 秒仍未返回数据时，连接会被网络层中断。请开启流式输出（"stream": true），绝大多数客户端默认就是流式的。

账户与安全

收不到验证码邮件？

邮件发件人是 [email protected]，请检查垃圾邮件文件夹，或几分钟后重新发送。

可以同时用邮箱、Google、GitHub 登录同一个账户吗？

可以。登录后在 安全与访问 中绑定其他登录方式即可。

密钥泄露了怎么办？

立即在控制台 API 密钥 中删除或禁用该密钥，再新建一个。建议给密钥设置额度和 IP 白名单，降低泄露损失。

计费

为什么扣费和我估算的不一样？

不同模型的输入、输出单价不同，部分模型的「思考」内容也计入输出 Token。每次调用的明细都可以在 使用日志 中查看。

余额用完会怎样？

请求会返回 403（额度不足），充值后立即恢复，不影响已有的密钥和配置。

联系我们

文档没有覆盖的问题，请发邮件到 [email protected]，附上发生时间、模型名和错误信息（不要发送完整密钥）。