Error handling
The API uses standard HTTP status codes and returns detailed error messages.
Error response format
json
{
"error": {
"code": "rate_limit_exceeded",
"message": "You have exceeded your monthly character limit",
"details": {
"limit": 100000,
"used": 100000
}
}
}Common error codes
| Status | Code | Description |
|---|---|---|
| 401 | unauthorized | Invalid or missing API key |
| 400 | invalid_request | Malformed request body |
| 429 | rate_limit_exceeded | Monthly limit exceeded |
| 500 | internal_error | Server error |