HTTP status codes
| Status | Meaning | Common cause |
|---|---|---|
| 400 | Bad request | Missing / malformed parameters |
| 401 | Unauthorized | Missing or wrong key |
| 403 | Forbidden | Key revoked / no access to the model |
| 404 | Not found | Path or model does not exist |
| 429 | Rate limited | See Rate Limits |
| 5xx | Upstream / gateway error | Retry or contact support |
Business error codes
Possible values of theerror.code field:
| code | Meaning | What to do |
|---|---|---|
invalid_request | Invalid request parameters | Check params and body |
bad_request_body | Malformed request body | Verify the JSON is valid |
read_request_body_failed | Failed to read request body | Check body and Content-Type |
convert_request_failed | Request conversion failed | Ensure params match the API format |
sensitive_words_detected | Sensitive content detected | Adjust the input |
prompt_blocked | Prompt was blocked | Adjust the prompt |
access_denied | Access denied | Check key, permissions, and group |
model_not_found | Model not found | Verify model and your plan’s models |
invalid_api_type | Unsupported API type | Use a supported API format |
get_channel_failed | No available channel | Retry later or contact support |
channel:no_available_key | No available channel key | Retry later or contact support |
channel:invalid_key | Invalid channel key | Contact support |
channel:model_mapped_error | Model mapping error | Contact support |
channel:response_time_exceeded | Upstream timeout | Retry; shrink the request if needed |
insufficient_user_quota | Insufficient quota | Top up or check your plan quota |
pre_consume_token_quota_failed | Quota pre-deduction failed | Check quota and retry |
model_price_error | Model pricing error | Contact support |
count_token_failed | Token counting failed | Check input and retry |
do_request_failed | Upstream request failed | Retry |
bad_response | Bad upstream response | Retry or contact support |
bad_response_status_code | Bad upstream status code | Retry or contact support |
empty_response | Empty upstream response | Retry; raise timeout for streaming |
read_response_body_failed | Failed to read upstream response | Retry |
json_marshal_failed | Serialization failed | Retry or contact support |
query_data_error | Data query error | Retry or contact support |
update_data_error | Data write error | Retry or contact support |