Skip to main content
Errors are returned in a normalized JSON envelope:
{
  "error": { "code": "RATE_LIMITED", "message": "Too many requests" }
}
Common codes:
  • AUTH_INVALID_KEY (401): Invalid or missing API key
  • RATE_LIMITED (429): Per-key rate limit exceeded
  • FILE_REQUIRED (400): Missing multipart file field
  • PASSWORD_REQUIRED (400): Missing password in body
  • UPLOAD_FAILED, CONVERT_FAILED, SET_PASSWORD_FAILED (5xx): Processing or upstream error