Skip to main content

​
Limitations

Understanding API limitations helps you better plan your application

​
API Limits

Limit ItemLimit ValueDescription
Prompt length2000 charactersRecommended to stay within 1000 characters for best results
Reference image countMaximum 5 imagesEach image not exceeding 10MB
Concurrent tasks10 tasksExceeding will return 429 error
Task timeout30 minutesTimeout tasks will be automatically cancelled
Video duration10-15 secondsVaries by model
Request frequency100 times/minuteExceeding 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 below 10MB
TASK_TIMEOUTTask timeoutResubmit task
INSUFFICIENT_BALANCEInsufficient balanceRecharge 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

Verify if it exceeds normal processing time (see model description)
2

Verify Task ID

Ensure using correct task ID for queries
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

​
Unsatisfactory Generation Quality

  • Prompt Optimization
  • 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 color 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)

​
FAQ

​
Technical Support

Encountered Issues?

If you encounter issues not covered in the documentation, please contact us through:
  • Email: [email protected]
  • WeChat: 8765058
  • Response time: Within 24 hours on business days
When contacting, please provide:
  • Task ID
  • Error information
  • Request parameters (hide sensitive info)
  • Issue description

​
Status Monitoring

Recommended to implement the following monitoring measures to detect and handle issues promptly:
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