遇到报错时,先按下面顺序排查。大多数问题都能在 2 分钟内定位。
教程重点:401 看 Key,404 看模型,429 看频率,余额不足看充值,timeout 看任务大小和网络。
1. 常见错误
| 现象 | 可能原因 | 处理方式 |
| 401 / unauthorized | API Key 错误、过期、复制不完整 | 重新复制 Key,确认没有空格。 |
| 404 / model not found | 模型名称写错 | 复制后台「可用渠道」里的模型名称。 |
| 429 / rate limit | 请求太频繁 | 降低并发,稍后再试。 |
| 余额不足 | 账号余额不够 | 充值或订阅后重试。 |
| timeout | 网络慢、任务太大、模型繁忙 | 缩短输入,换模型或稍后重试。 |
| invalid base url | 接口地址写错 | 检查是否多写或少写 /v1。 |
2. 后台排查路径
- 先看「仪表盘」确认余额。
- 再看「可用渠道」确认模型状态。
- 最后看「使用记录」定位具体请求。
3. 找客服前准备
- 账号或订单信息。
- 工具名称和系统:Windows 还是 Mac。
- 模型名称。
- 报错截图。
- 后台使用记录截图。
- 不要发送完整 API Key。
版权声明:本文由像素群岛编写并维护,版权归像素群岛所有。未经许可,请勿转载、搬运或用于商业培训材料。