Skip to main content
All errors return specific codes in the message field for programmatic handling.

​
Error Categories

  • User Errors
  • Content Errors
  • System Errors
Issues caused by invalid requests or insufficient resources.
Description: Not enough credits to complete the requestSolution: Add more credits to your account
{
  "success": false,
  "message": "INSUFFICIENT_CREDITS"
}
Description: Generation with specified ID does not existSolution: Verify the generation ID is correct
{
  "detail": "Generation not found"
}
Description: Request parameters are invalid or missing required fieldsSolution: Check parameter values and types
{
  "detail": "Validation error: prompt is required"
}
Description: One or more input images are not validSolution: Ensure you’re uploading valid JPEG, PNG, or WEBP files
{
  "status": "failed",
  "message": "INVALID_IMAGE"
}
Description: One or more image URLs are inaccessibleSolution: Verify all image URLs are accessible via HTTPS
{
  "status": "failed",
  "message": "IMAGE_INACCESSIBLE"
}
Description: More than 5 reference images providedSolution: Limit reference images to maximum of 5
{
  "detail": "Maximum 5 reference images allowed"
}

​
Complete Error Reference

​
INSUFFICIENT_CREDITS
User Error
Not enough credits to complete the request
​
GENERATION_NOT_FOUND
User Error
Generation with specified ID does not exist
​
INVALID_PARAMETERS
User Error
Invalid input format or missing required fields
​
INVALID_IMAGE
User Error
One or more input images are not valid
​
IMAGE_INACCESSIBLE
User Error
One or more image URLs are inaccessible
​
TOO_MANY_IMAGES
User Error
More than 5 reference images provided
​
CONTENT_POLICY_VIOLATION
Content Error
Content violates usage policies
​
MODERATION_FAILED
Content Error
Content rejected by moderation system
​
TIMEOUT
System Error
Task exceeded maximum processing time (15 minutes)
​
TASK_FAILED
System Error
Generation failed due to system error
​
SERVICE_UNAVAILABLE
System Error
Service is temporarily unavailable

​
HTTP Status Code Reference

​
201
Created
Generation created successfully
​
200
OK
Request successful
​
400
Bad Request
Invalid parameters or request format
​
401
Unauthorized
Invalid or missing API key
​
402
Payment Required
Insufficient credits
​
404
Not Found
Generation not found
​
422
Validation Error
Invalid input format or missing required fields
​
500
Internal Server Error
Server-side error
​
503
Service Unavailable
Service temporarily unavailable
Always handle errors programmatically using the error codes, not human-readable messages.