常见报错排查
调用失败时,报错里的状态码基本能定位问题。先按这张表自查,多数情况一分钟就能解决。
| 状态码 / 提示 | 是什么意思 | 怎么自查 |
|---|---|---|
| 401 Invalid token |
令牌不对:没带、填错或已失效 | 检查请求头是 Authorization: Bearer sk-...;令牌复制时有没有多空格、少字符;是不是把别的站的 Key 填过来了;在控制台令牌页确认该令牌还在、未被删除。 |
| 403 余额不足 / insufficient quota |
账号余额或令牌额度不够了 | 去控制台「钱包」看余额是否为 0;如果给令牌设过额度上限,去令牌页看剩余额度;充值或调高限额后重试。 |
| 403 无权访问该模型 / 分组 |
你的令牌所在分组没有这个模型 | 以控制台「模型」页里你能看到的模型为准;或在令牌页把令牌分组改成包含该模型的分组。 |
| 404 模型不存在 / 路径错误 |
模型名写错,或接口地址拼错 | 模型名照抄「模型」页,别自己拼;接口地址是 https://chy.best/v1;用 Claude Code 时注意 Base URL 不要加 /v1(见 Claude Code 配置)。 |
| 429 Too Many Requests |
请求太频繁,触发限流 | 降低并发、给程序加重试间隔;批量任务分批跑;稍等一两分钟再试。 |
| 500 / 502 / 503 | 上游通道临时异常,不是你的问题 | 等几分钟重试;急用可以先换一个同档模型;持续半小时以上再联系我们,并附上发生时间。 |
| 连接超时 / 证书错误 | 网络没通到本站 | 确认地址以 https:// 开头、没有多余路径;换个网络试试;公司网/校园网可能拦截,换热点验证一下。 |
自查三件套
- 看日志:控制台「日志」页有每一笔调用的时间、模型和结果,失败原因在那里看得最准;
- 对配置:Base URL、令牌、模型名——九成问题出在这三样里的一样写错了;
- 小步验证:先用 快速开始 里的 curl 例子测一笔,curl 能通就是你程序/客户端的配置问题,curl 也不通再来找我们。
联系客服求助时请提供:发生时间、使用的模型名、报错截图或原文,发到 support@chy.best。切记不要把完整令牌发出来——正规客服永远不会向你索要令牌。