Error Handling

​

Common Error Types

​

ValidationError

{
  "error": "ValidationError",
  "message": "source_lang is required"
}

• Missing required fields
• Invalid language codes
• Malformed request body
• Invalid parameter values

• Check all required fields are provided
• Validate language codes against Get Options
• Ensure request body is valid JSON

​

UnauthorizedError

{
  "error": "UnauthorizedError", 
  "message": "Invalid API key"
}

• Missing Authorization header
• Invalid API key
• Expired API key
• Wrong API key for the environment

• Include Authorization: Bearer YOUR_API_KEY header
• Verify your API key is correct and active
• Generate a new API key if needed

​

PaymentRequiredError

{
  "error": "PaymentRequiredError",
  "message": "Insufficient balance for this project"
}

• Account balance too low
• Feature requires active subscription
• Plan limits exceeded

• Check balance with Get Balance
• Top up your account
• Upgrade your subscription plan

​

VideoInfoError

{
  "error": "VideoInfoError",
  "message": "Unable to process the provided video URL"
}

• Invalid video URL
• Video file corrupted or inaccessible
• Unsupported video format
• Video too large or too long

• Verify video URL is accessible
• Check video format is supported
• Ensure video meets size/duration limits

​

NotFoundError

{
  "error": "NotFoundError",
  "message": "Project not found"
}

• Invalid project ID
• Resource was deleted
• Wrong endpoint URL

• Verify the resource ID is correct
• Check if the resource was deleted
• Ensure you’re using the correct endpoint

​

RateLimitError

{
  "error": "RateLimitError",
  "message": "Rate limit exceeded. Please try again later"
}

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1640995200