Most error responses return a JSON body with:Documentation Index
Fetch the complete documentation index at: https://pixa.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
error: human-readable messageerror_code: machine-readable code for programmatic handling
Common status codes
400invalid request (for example: image too large, unsupported format)401invalid or missing API key (invalid_auth_token)403insufficient credits (insufficient_api_credits)429rate limit exceeded (rate_limit_exceeded)500internal error (retryable)
400 error codes (examples)
Commonerror_code values include:
missing_parameter,invalid_parameterunsupported_image_format,malformed_imagefile_size_too_large,resolution_too_highunknown_foreground(foreground subject not detected)
Logging recommendations
- Log: endpoint, status code,
error_code, and a request timestamp - Redact: API keys, signed URLs, and user PII