报错代码说明

报错代码说明

调用 API 或使用网站遇到报错时,对照本文排查。

401 Unauthorized

含义:API Key 无效。

排查:

  1. Key 是否复制完整(sk- 开头,无多余空格)
  2. Key 是否已被删除,到 API Key 管理 确认
  3. 环境变量是否生效(重新打开终端)

403 Forbidden

含义:没有权限访问该资源。

排查:Key 被禁用,或 IP 被限制。到 API Key 管理 检查 Key 状态。

404 Not Found

含义:模型不存在或路径错误。

排查:

  1. 模型名是否和模型广场完全一致(区分大小写)
  2. Base URL 是否带 /v1 后缀

429 Too Many Requests

含义:请求过于频繁,触发限速。

解决:稍等几秒重试;高频场景在代码中加入重试逻辑。

余额不足

含义:账户余额不够本次调用。

解决:到充值页面充值。

500 / 502 / 503

含义:服务端临时错误。

解决:稍后重试。持续出现,到我的表单提交工单。