Errors

Public error model for invalid uploads, auth failures, credit failures, and provider failures.

Errors use a stable code and retryability flag.

{
  "error": {
    "code": "upload_too_large",
    "message": "The uploaded image exceeds the 10485760 byte limit.",
    "retryable": false
  }
}

Code	Retryable	Meaning
`invalid_api_key`	no	The bearer token is missing, revoked, unknown, or no dashboard session was present.
`invalid_upload`	no	The request does not include exactly one valid image upload.
`upload_too_large`	no	The image exceeds the public size cap.
`insufficient_credits`	no	The organization does not have prepaid credits available.
`rate_limited`	yes	The authenticated subject exceeded its organization-scoped request limit.
`provider_failure`	yes	The verifier failed before producing a result.