Error Codes
HTTP status codes and error handling
API Configuration
After saving, the Try It panel below sends real requests with this key.
Base: api.xrtoken.ai
Error Response Format
All errors return a consistent JSON format:
{
"error": {
"message": "Error description",
"type": "error_type"
}
}Status Codes
| HTTP Status | Meaning | Recommended Action |
|---|---|---|
400 | Bad Request | Check required fields like model, messages |
401 | Unauthorized | Verify API Key is correct and not revoked |
402 | Insufficient Balance | Top up your account |
429 | Rate Limited | Reduce request frequency; current limit is 60 RPM |
502 | Upstream Error | Provider temporarily unavailable; retry later |
503 | Service Unavailable | System maintenance; retry later |
Retry Guidelines
429-- Use exponential backoff, max interval 60 seconds502/503-- Wait 5-10 seconds before retrying, max 3 retries400/401/402-- Do not retry; fix request params or account status