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: Task with specified ID does not existSolution: Verify the task ID is correct
{
  "detail": "TASK_NOT_FOUND"
}
Description: Task ID format is invalid (must be valid UUID)Solution: Use the task ID returned from generate endpoint
Description: Uploaded file is not a valid imageSolution: Ensure you’re uploading a valid JPEG, PNG, or WEBP file
Description: Image file size exceeds 20MB limitSolution: Compress your image or use a smaller file
Description: Image format not supportedSolution: Convert to JPEG, PNG, or WEBP format

​
Complete Error Reference

​
INSUFFICIENT_CREDITS
User Error
Not enough credits to complete the request
​
NON_ENGLISH_PROMPT
Content Error
Prompt contains non-English text (Google Veo3 limitation)
​
UNSAFE_CONTENT
Content Error
Content detected as unsafe by Google’s safety filters
​
PROMINENT_PEOPLE_UPLOAD
Content Error
Image contains recognizable prominent people
​
PHOTOREAL_UPLOAD
Content Error
Photorealistic people (Google randomly rejects ~50% of such images)
​
MODERATION_FAILED
Content Error
Content rejected by RunBlob moderation system
​
GOOGLE_DECLINED
System Error
Google service declined the request
​
TASK_FAILED
System Error
Google interrupted generation after detecting unacceptable content during processing
​
TASK_NOT_FOUND
User Error
Task with specified ID does not exist
​
INVALID_TASK_ID
User Error
Task ID format is invalid (must be valid UUID)
​
TIMEOUT
System Error
Task exceeded maximum processing time (10 minutes)
​
MAINTENANCE
System Error
Service is temporarily unavailable for maintenance
​
INVALID_IMAGE
User Error
Uploaded file is not a valid image
​
IMAGE_TOO_LARGE
User Error
Image file size exceeds 20MB limit
​
UNSUPPORTED_IMAGE_FORMAT
User Error
Image format not supported (only JPEG, PNG, WEBP allowed)
Always handle errors programmatically using the error codes, not human-readable messages.