Skip to main content
When calling the API, the response code consists of two parts: the outer layer is the HTTP status code, and the inner layer is the business error code defined by Z.AI in the response body, which provides a more detailed error description.
Error Codes​HTTP Status CodeError messege
-500Internal Error
1000401Authentication Failed
1001401Authentication parameter not received in Header, unable to authenticate
1003401Authentication Token expired, please regenerate/obtain
1005401Need Two-Factor Authentication
1113429Insufficient balance or no resource package. Please recharge.
1200500API Call Error
1210400Invalid API parameter, please check the documentation.
1211400Unknown Model, please check the model code.
1212400Current model does not support ${method} call method
1213400Parameter ${field} was not received.
1214400Parameter ${field} is invalid. Please check the documentation.
1215400${field1} and ${field2} cannot be set simultaneously, please check the documentation
1220403You do not have permission to access $
1221400API ${API_name} has been taken offline
1222400API ${API_name} does not exist
1230500API call process error
1234500Network error, error id: ${error_id}, please try again later
1261400Prompt too long
1301400System detected potentially unsafe or sensitive content in input or generation. Please avoid using prompts that may generate sensitive content. Thank you for your cooperation.
1302429Rate limit reached for requests
1305429The service may be temporarily overloaded, please try again later
1308429Usage limit reached for {number} {unit}. Your limit will reset at {next_flush_time}
1309429Your GLM Coding Plan package has expired and is temporarily unavailable. You can resume using it after renewing the subscription on the official website. https://z.ai/subscribe。
1310429Weekly/Monthly Limit Exhausted. Your limit will reset at {next_flush_time}
1311429Your current subscription plan does not yet include access to ${model_name}
1313429Your account’s current usage pattern does not comply with the Fair Usage Policy, and your request frequency has been limited. For details, please refer to the Subscription Service Agreement. To restore access, please submit a request.
1314429Your enterprise package has expired. Please contact your enterprise administrator.
1315429This API Key is limited to enterprise coding package scenarios. Please go to the official website to replace the API Key of the corresponding product type.
1316429Usage limit reached for the past 5 hours. Insufficient balance for extra usage. Resets at {next_flush_time}.
1317429Usage limit reached for the past 7 days. Insufficient balance for extra usage. Resets at {next_flush_time}.
1318429Usage limit reached for the past 5 hours. Extra usage is not available due to monthly spend limit. Resets at {next_flush_time}.
1319429Usage limit reached for the past 7 days. Extra usage is not available due to monthly spend limit. Resets at {next_flush_time}.
1320429Usage limit reached for the past 5 hours. Extra usage is not available due to monthly spend limit. Resets at {next_flush_time}.
1321429Usage limit reached for the past 7 days. Extra usage is not available due to monthly spend limit. Resets at {next_flush_time}.

​
Error Shapes

Errors are always returned as JSON, with a top-level error object that includes a code and message value. 
{
  "error": {
    "code": "1214",
    "message": "Parameter `${field}` is invalid. Please check the documentation."
  }
}

​
Error Example

The following is the response message of a curl request, where 401 is the HTTP status code and 1001 is the business error code. 
* We are completely uploaded and fine
< HTTP/2 401
< date: Wed, 20 Mar 2024 03:06:05 GMT
< content-type: application/json
< set-cookie: acw_tc=76b20****a0e42;path=/;HttpOnly;Max-Age=1800
< server: nginx/1.21.6
< vary: Origin
< vary: Access-Control-Request-Method
< vary: Access-Control-Request-Headers
<
* Connection #0 to host open.z.ai left intact
{"error":{"code":"1001","message":"Authentication parameter not received in Header, unable to authenticate"}}
Note: When using streaming (SSE) calls, if the API terminates abnormally during inference, the above error codes will not be returned. Instead, the reason for the exception will be provided in the finish_reason parameter of the response body. For details, please refer to the description of the finish_reason parameter.