Skip to main content

​
API Limitations

Understanding API limitations helps better plan your application

​
API Limits

LimitationValueDescription
Prompt length2000 charactersRecommend keeping under 1000 characters for best results
Reference image countMax 5 imagesEach image under 10MB
Concurrent tasks10 tasksExceeding will return 429 error
Task timeout30 minutesTimeout tasks will be automatically cancelled
Video duration10-15 secondsVaries by model
Request frequency100 requests/minExceeding limit will be rate-limited

​
Image Format Requirements

  • Supported Formats
  • Image Specifications
  • JPEG (.jpg, .jpeg)
  • PNG (.png)
  • WebP (.webp)

​
HTTP Error Codes

​
4xx Client Errors

​
5xx Server Errors

​
API Error Codes

​
Common Error Code List

Error CodeDescriptionSolution
INVALID_PROMPTInvalid promptCheck prompt length and content
INVALID_MODELModel does not existUse supported model names
QUOTA_EXCEEDEDQuota exceededContact to increase quota
TASK_NOT_FOUNDTask does not existCheck task ID
INVALID_IMAGE_URLInvalid image URLEnsure image is accessible
IMAGE_TOO_LARGEImage too largeCompress image to under 10MB
TASK_TIMEOUTTask timeoutResubmit task
INSUFFICIENT_BALANCEInsufficient balanceTop up account

​
Error Response Format

{
  "success": false,
  "message": "Error description",
  "error_code": "ERROR_CODE",
  "details": {
    "field": "Specific error field",
    "reason": "Error reason",
    "suggestion": "Solution suggestion"
  }
}

​
Troubleshooting Guide

​
Task Stuck in processing Status

1

Check Task Duration

Confirm if exceeds normal processing time (see model documentation)
2

Verify Task ID

Ensure using correct task ID for query
3

Check API Status

Visit status page or contact support to confirm service status
4

Retry Submission

If exceeds 30 minutes, task may have timed out, please resubmit

​
Poor Generation Quality

  • Optimize Prompt
  • Use Reference Images
  • Enable Enhancement
  • Choose Appropriate Model
# Before optimization
prompt = "cat"

# After optimization
prompt = """
An orange British Shorthair cat in a sunny living room,
lazily lying on a soft sofa,
afternoon sunlight streaming through the window onto it,
4K quality, warm tones
"""

​
Network Error Handling

import requests
from requests.adapters import HTTPAdapter
from requests.packages.urllib3.util.retry import Retry

def create_session():
    session = requests.Session()
    retry = Retry(
        total=3,
        read=3,
        connect=3,
        backoff_factor=0.3,
        status_forcelist=(500, 502, 504)
    )
    adapter = HTTPAdapter(max_retries=retry)
    session.mount('http://', adapter)
    session.mount('https://', adapter)
    return session

# Use session with retry
session = create_session()
response = session.post(url, json=data, headers=headers)

​
Common Questions FAQ

​
Technical Support

Encountering Issues?

If you encounter issues not covered in the documentation, please contact us via:When contacting, please provide:
  • Task ID
  • Error message
  • Request parameters (hide sensitive information)
  • Problem description

​
Status Monitoring

Recommend implementing the following monitoring measures to promptly detect and handle issues:
class VEOMonitor:
    def __init__(self):
        self.success_count = 0
        self.failure_count = 0
        self.total_duration = 0
        
    def record_success(self, duration):
        self.success_count += 1
        self.total_duration += duration
        
    def record_failure(self, error_code):
        self.failure_count += 1
        # Record error type for analysis
        
    def get_success_rate(self):
        total = self.success_count + self.failure_count
        return self.success_count / total if total > 0 else 0
        
    def get_average_duration(self):
        return self.total_duration / self.success_count if self.success_count > 0 else 0
⌘I