> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rixapi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 错误处理

## 常见错误代码及原因：

* 400：参数不正确，请参考报错信息（message）修正不合法的请求参数；
* 401：API Key 没有正确设置；
* 403：账户余额不足或者权限不够，权限不够最常见的原因是该模型需要实名认证，其他情况参考报错信息（message）；
* 404：任务不存在。查询任务，或基于已有任务续接（如 remix、延长、对口型）时，传入的任务 ID 不存在、已过期或不属于当前账号，报错信息里会带上该 ID。可灵、Midjourney 等原生格式接口按各自官方协议返回（例如可灵为 400 + 业务码 1201）；
* 429：
  * 触发了 rate limits；参考报错信息（message）判断触发的是 `RPM /RPD / TPM / TPD / IPM / IPD` 中的具体哪一种，可以参考 Rate Limits 了解具体的限流策略；
  * 也有可能是传递了错误参数，导致一直错误重试最后触发限速。
* 504 / 503：一般是服务系统负载比较高，可以稍后尝试；
  对于对话和文本转语音请求，可以尝试使用流式输出（“stream” : true），参考 流式输出；
* 500：服务发生了未知的错误，可以联系相关人员进行排查

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

```http theme={null}
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"
    }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.