新手入门
新手报错自查
调用失败时，按提示信息逐项排查最常见的原因。
| 你看到的提示 | 最常见的原因 | 怎么办 |
|---|---|---|
| 401 / 认证失败 / invalid api key | Key 复制不完整、多了空格，或已被撤销 | 重新复制 Key，注意首尾不要有空格 |
| 404 / model not found | 模型 ID 写错，或地址多写、少写了 /v1 | 到模型广场复制 ID；客户端地址按说明填写 |
| 402 / 余额不足 | 账户余额用完了 | 充值后再试 |
| 403 / 额度已用完 | Key 的预算用完，或老师分配的额度用完 | 调高预算，或联系分配额度的老师 |
| 429 / 请求太频繁 | 短时间内请求太多 | 等几秒再试，或降低并发 |
| 连接超时、一直转圈 | 网络问题，或回答太长 | 检查网络；在提问里限制回答长度 |
| 回答突然中断 | 网络断开或达到 max_tokens 上限 | 重新提问；需要长回答时调大上限 |
地址到底要不要写 /v1？
| 场景 | 地址 |
|---|---|
| 写代码（OpenAI SDK）、ChatBox、Cursor 等 | https://api.example.cn/v1 |
| Cherry Studio | https://api.example.cn（它会自动补全） |
| Claude Code（Anthropic 协议） | https://api.example.cn（不带 /v1） |
还是解决不了？
在控制台找到这次请求的 request_id，联系支持时附上，我们能更快定位问题。更多错误说明见 错误码与限流。