错误处理 - API Docs

常见错误代码及原因：

常见错误代码及原因：

400：参数不正确，请参考报错信息（message）修正不合法的请求参数；
401：API Key 没有正确设置；
403：账户余额不足或者权限不够，权限不够最常见的原因是该模型需要实名认证，其他情况参考报错信息（message）；
429：
- 触发了 rate limits；参考报错信息（message）判断触发的是 RPM /RPD / TPM / TPD / IPM / IPD 中的具体哪一种，可以参考 Rate Limits 了解具体的限流策略；
- 也有可能是传递了错误参数，导致一直错误重试最后触发限速。
504 / 503：一般是服务系统负载比较高，可以稍后尝试；对于对话和文本转语音请求，可以尝试使用流式输出（“stream” : true），参考流式输出；
500：服务发生了未知的错误，可以联系相关人员进行排查

通常情况，我们会将错误原因写在响应中，尽量把错误码和报错信息（message）打印出来，利用这些信息，可以定位大部分问题。

HTTP/1.1 503 Service Unavailable
Date: Thu, 19 Dec 2024 08:39:19 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 192
Connection: keep-alive
X-Rixapi-Request-Id: 202511162255194339355347BE3UyUY

{
    "error": {
        "code": "",
        "message": "所有令牌分组 default 下对于模型 gpt 均无可用渠道，请更换分组尝试 (request id: 202511162255194339355347BE3UyUY)",
        "type": "rix_api_error"
    }
}

⌘I