API 报错排查

如果接口调用失败，不要急着重建所有配置。先按下面顺序排查，通常可以很快定位问题。

先检查四个核心参数

参数	检查方式
Base URL	是否为 https://app.runcode.win，或是否按客户端要求补了 /v1
API Key	是否为中转站创建的 sk-...，没有多复制空格或换行
Model	是否和中转站模型列表、分组或「使用密钥」弹窗一致
额度	卡密是否兑换成功，账号是否仍有可用额度或套餐

常见错误

认证失败

通常是 API Key 错误、Key 被删除、复制时混入空格，或填到了错误的 Provider。请重新复制 API Key，并确认客户端选择的是 API Compatible。

模型不存在

模型名称需要和中转站展示保持一致。不要直接照搬其他平台的模型名，先在中转站模型列表或「使用密钥」弹窗中确认。

余额不足

进入中转站查看余额、套餐或分组是否可用。如果刚购买卡密，请先确认兑换成功。

连接失败

检查网络是否能访问 https://app.runcode.win/。如果浏览器也无法打开，先排查本地网络、代理或 DNS。

请求格式错误

RuncodeAI 使用 API 兼容接口。自己的代码项目里请确认请求路径、请求体和 SDK 配置都遵循 API Compatible 的写法。

常见错误解决方法

除了 503 报错以外，大部分问题通常都和本地配置有关，建议先自行检查 Base URL、API Key、模型名称、客户端类型和请求格式。

也可以打开 https://chat.deepseek.com/ 让 AI 协助排查。提问时建议提供：

• 使用场景，例如 Codex、CC、Chatbox 或自己的代码项目。
• Base URL，例如 https://app.runcode.win。
• 客户端配置截图或配置片段。
• 完整报错信息。
• API Key 的脱敏版本，例如只保留前 6 位和后 4 位。

WARNING

不要把完整 API Key 发给任何第三方 AI、公开网页、群聊或论坛。需要排查时请先把中间部分打码，例如 sk-abc123...wxyz。

如果是 503 报错，可能是上游服务、模型通道或网络链路临时异常。可以稍后重试；如果持续出现，再联系售后并附上报错时间、模型名称和请求场景。

仍然无法解决

联系售后时建议提供：

• 使用场景，例如 Codex、Chatbox、代码项目。
• 报错截图或完整错误信息。
• Base URL 和模型名称。
• 中转站账号信息。
• 订单号或兑换记录。

不要把完整 API Key 发到公开渠道。