不掺水的中转站中转 API 常见报错和解决方法
401、404、429、503 和 No available channel 这些中转 API 常见报错的原因和解决方法。
| 报错 | 常见原因 | 解决方法 |
|---|---|---|
401 | Key 填错、被作废或已过期 | 检查 Key 有没有多余的空格，或者在控制台新建一个 |
403 | 账户或令牌没有这个模型的权限 | 检查令牌的可用模型设置 |
404 | Base URL 写错，常见的是少了或多了 /v1 | 对照对应客户端的教程检查地址 |
429 | 请求太频繁，或上游限流 | 降低并发，稍后重试 |
503 / No available channel | 模型名写错，或者该模型当前不可用 | 对照模型广场检查模型名，注意大小写和版本号 |
| 余额不足 | 账户或令牌的额度用完 | 到控制台充值，或调高令牌额度 |
响应慢或首字节慢
高推理强度的模型思考时间较长，首字节慢不一定是故障。开启流式输出可以更早看到内容，同时把客户端的超时时间调长。
排查顺序
- 确认 Base URL 和 Key 没有填错。
- 用教程里的 curl 命令测试，排除客户端的问题。
- 查看控制台日志里有没有这次请求。没有记录，说明请求没有到达服务。
- 还是不行，把日志截图和报错内容发给客服。