Skip to main content

​
Common Error Codes and Causes:

  • 400: The parameters are incorrect. Please refer to the error message (message) to correct the invalid request parameters;
  • 401: API Key is not set correctly;
  • 403: Insufficient account balance or insufficient permissions. The most common reason for insufficient permissions is that the model requires identity verification. In other cases, refer to the error message (message);
  • 429:
    • Rate limits are triggered; refer to the error message (message) to determine which specific limit was triggered among RPM / RPD / TPM / TPD / IPM / IPD. Please refer to Rate Limits to learn the specific rate limiting strategy;
    • It is also possible that wrong parameters were passed, causing repeated error retries and finally triggering the rate limit.
  • 504 / 503: Generally, the service system load is relatively high. You can try again later;
    • For conversation and text-to-speech requests, you can try using streaming output ("stream": true), see Streaming Output;
  • 500: An unknown error occurred in the service. You can contact relevant personnel for troubleshooting.
Normally, we will write the cause of the error in the response. Try to print out the error code and error message (message). Using this information, you can locate most problems. 
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": "There are no channels available for model gpt under all token groups default, please try changing the group (request id: 202511162255194339355347BE3UyUY)",
    "type": "rix_api_error"
  }
}