错误码

出错时接口返回非 2xx 状态码，响应体中通常包含 error.message 说明原因。

状态码	常见原因	处理方法
`400`	请求参数有误，例如模型不支持某个参数、消息格式错误	检查请求体；对照模型说明调整参数
`401`	密钥无效、已删除、已过期，或请求头格式不对	检查 `Authorization: Bearer sk-...` 是否正确；到控制台确认密钥状态
`403`	余额或密钥额度不足；密钥不允许调用该模型；IP 不在白名单	充值或调高密钥额度；检查密钥的模型限制与 IP 白名单
`404`	接口路径错误（常见于 Base URL 多加或少加了 `/v1`）；模型名不存在	对照客户端接入总览修正地址；核对模型名
`429`	请求过于频繁，触发限流；或上游暂时繁忙	降低并发，稍后重试（建议指数退避）
`500` / `502` / `503`	上游模型服务异常或暂时不可用	稍后重试；持续出现请联系我们
`524`	非流式请求超过约 100 秒仍未返回数据，连接被网络层中断	改用流式输出（`"stream": true`）

重试建议

对 429 和 5xx 错误，建议使用指数退避重试，例如等待 1s、2s、4s 后再试，最多 3～5 次。不要对 400、401、403、404 重试，这些错误需要先修正请求或账户设置。