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

StatusCodeDescription
401unauthorizedInvalid or missing API key
400invalid_requestMalformed request body
429rate_limit_exceededMonthly limit exceeded
500internal_errorServer error