报错代码说明
调用 API 或使用网站遇到报错时,对照本文排查。
401 Unauthorized
含义:API Key 无效。
排查:
- Key 是否复制完整(
sk-开头,无多余空格) - Key 是否已被删除,到 API Key 管理 确认
- 环境变量是否生效(重新打开终端)
403 Forbidden
含义:没有权限访问该资源。
排查:Key 被禁用,或 IP 被限制。到 API Key 管理 检查 Key 状态。
404 Not Found
含义:模型不存在或路径错误。
排查:
- 模型名是否和模型广场完全一致(区分大小写)
- Base URL 是否带
/v1后缀
429 Too Many Requests
含义:请求过于频繁,触发限速。
解决:稍等几秒重试;高频场景在代码中加入重试逻辑。
余额不足
含义:账户余额不够本次调用。
解决:到充值页面充值。
500 / 502 / 503
含义:服务端临时错误。
解决:稍后重试。持续出现,到我的表单提交工单。