Errors
错误码与排查
先确认 Base URL、Key、模型名、余额，再带 request id 联系支持。
认证与 Key
| 状态 | 含义 | 处理方式 |
|---|---|---|
| 401 API_KEY_REQUIRED | 没有带 Key 或格式错误。 | 使用 Authorization: Bearer bc-live-...。 |
| 401 UNAUTHORIZED | 用户接口需要登录。 | 重新登录控制台并完成邮箱验证码。 |
| 403 disabled | Key、用户或分组被禁用。 | 检查 Key 状态，必要时重新创建。 |
模型名
| 状态 | 含义 | 处理方式 |
|---|---|---|
| 400 unsupported model | 请求了非 GPT 模型。 | 改用 gpt-5.5 或 gpt-5.4。 |
| 404 route not found | 接口路径不对。 | OpenAI compatible 使用 https://api.berrycode.club/v1。 |
余额与限速
| 状态 | 含义 | 处理方式 |
|---|---|---|
| 402 insufficient balance | 余额不足。 | 进入控制台充值。 |
| 429 rate limit | 请求过快或并发过高。 | 降低并发，稍后重试。 |
| 503 unavailable | 上游暂时不可用。 | 查看状态页，稍后重试。 |