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
{
  "detail": "INSUFFICIENT_CREDITS"
}
Description: Generation with specified ID does not existSolution: Verify the generation ID is correct
{
  "detail": "Generation not found"
}
Description: Duration not allowed for selected generation modeSolution: Use "5" or "10" for text-to-video, or provide images for custom durations
{
  "detail": "Duration 3 seconds is only available for image-to-video generation"
}
Description: One or more input images are not validSolution: Ensure you’re uploading valid JPEG, PNG, or WEBP files under 10MB
{
  "status": "failed",
  "message": "INVALID_IMAGE"
}
Description: One or more image URLs returned 404 or 403Solution: Verify all image URLs are publicly accessible
{
  "status": "failed",
  "message": "IMAGE_INACCESSIBLE"
}
Description: More than 5 images providedSolution: Limit images to maximum of 5 per request
{
  "detail": "Maximum 5 images allowed"
}

​
Complete Error Reference

​
INSUFFICIENT_CREDITS
User Error
Not enough credits to complete the request
​
CONTENT_POLICY_VIOLATION
Content Error
Content violates usage policies (adult, violence, prohibited content)
​
IMAGE_INACCESSIBLE
User Error
One or more image URLs are inaccessible (404, 403)
​
INVALID_IMAGE
User Error
Image format is invalid or corrupted
​
TIMEOUT
System Error
Task exceeded maximum processing time (15 minutes)
​
TASK_FAILED
System Error
Generation failed due to system error
​
MAINTENANCE
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

​
Common Issues & Solutions

​
Issue: “Duration X seconds is only available for image-to-video”

Cause: Using duration "3", "4", "6", "7", "8", or "9" without providing images. Solution:
  • Use "5" or "10" for text-to-video
  • OR provide images to use custom durations

​
Issue: “IMAGE_INACCESSIBLE” error

Cause: The provided images_urls returned 404 or 403. Solution:
  • Verify URLs are publicly accessible
  • Check URLs don’t require authentication
  • Use images_base64 instead if URLs are private

​
Issue: “CONTENT_POLICY_VIOLATION”

Cause: AI detected prohibited content (adult, violence, etc.) Solution:
  • Review and modify your prompt
  • Check input images for inappropriate content
  • Avoid explicit or graphic descriptions

​
Issue: Generation stuck in “pending”

Cause: Workers might be overloaded or service experiencing high load. Solution:
  • Wait 1-2 minutes, status should change to “processing”
  • If stuck for >5 minutes, contact support with generation_id
Always handle errors programmatically using the error codes, not human-readable messages.