错误处理

​

常见错误代码及原因：

• 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：服务发生了未知的错误，可以联系相关人员进行排查

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"
    }
}