Documentation Index Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
Use this file to discover all available pages before exploring further.
⚠️ This documentation is for legacy custom API, not recommended The newer entry is Veo-3.1 Troubleshooting , but the Veo-3.1 legacy route has been temporarily unavailable since May 14, 2026. Check the current route incident first instead of assuming this is a legacy custom API parameter issue. API Limitations Understanding API limitations helps better plan your application
API Limits Limitation Value Description Prompt length 2000 characters Recommend keeping under 1000 characters for best results Reference image count Max 5 images Each image under 10MB Concurrent tasks 10 tasks Exceeding will return 429 error Task timeout 30 minutes Timeout tasks will be automatically cancelled Video duration 10-15 seconds Varies by model Request frequency 100 requests/min Exceeding limit will be rate-limited
HTTP Error Codes 4xx Client Errors
5xx Server Errors
API Error Codes Common Error Code List Error Code Description Solution INVALID_PROMPTInvalid prompt Check prompt length and content INVALID_MODELModel does not exist Use supported model names QUOTA_EXCEEDEDQuota exceeded Contact to increase quota TASK_NOT_FOUNDTask does not exist Check task ID INVALID_IMAGE_URLInvalid image URL Ensure image is accessible IMAGE_TOO_LARGEImage too large Compress image to under 10MB TASK_TIMEOUTTask timeout Resubmit task INSUFFICIENT_BALANCEInsufficient balance Top up account
{ "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
Check Task Duration
Confirm if exceeds normal processing time (see model documentation)
Verify Task ID
Ensure using correct task ID for query
Check API Status
Visit status page or contact support to confirm service status
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 """
# Add high-quality reference images images = [ "https://example.com/cat-reference-1.jpg" , "https://example.com/cat-reference-2.jpg" ]
# Enable prompt enhancement enhance_prompt = True
# For high-quality requirements, choose Pro version model = "veo3-pro"
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
