Skip to main content

​
Common error codes and causes:

  • 400: The parameters are incorrect. Please refer to the error message (message) to correct the illegal 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 real-name authentication. In other cases, refer to the error message (message);
  • 429：
    • Rate limits are triggered; refer to the error message (message) to determine what is triggeredRPM /RPD / TPM / TPD / IPM / IPDFor specific ones, 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 it later; For conversations 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, and try to print out the error code and error message. We can use this information to locate most problems. 
HTTP/1.1 503 Service Unavailable
Dell: Three, 19 December 08 08:39:19 GOT
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"
    }
}