Submit Video Task
Submit a video generation task
Request Parameters
Text description for video generation
Model name. Available options:
veo3 - Standard versionveo3-fast - Fast versionveo3-pro - Professional versionveo3-pro-frames - Professional version + frame control
Array of reference image URLs, maximum 5 images
Whether to enhance the prompt
Request Examples
curl -X POST "https://api.apiyi.com/veo/v1/api/video/submit" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-api-key" \
-d '{
"prompt": "A cat walking on a rainy night, preparing to catch a mouse",
"model": "veo3",
"images": ["https://example.com/cat.png"],
"enhance_prompt": true
}'
Response Example
{
"success": true,
"data": {
"taskId": "veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
"pollingUrl": "https://asyncdata.net/source/veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
"status": "processing",
"message": "Task submitted successfully"
}
}
Query Task Status
/veo/v1/api/video/status/{taskId}
Query video generation status
Path Parameters
Task ID (returned from submit endpoint)
Request Examples
curl -X GET "https://api.apiyi.com/veo/v1/api/video/status/veo3:b873872e-7358-4c2f-8d55-bd23f000e14e" \
-H "Authorization: Bearer your-api-key"
Response Status
Task Submitted
Downloading Images
Generating Video
Generation Complete
{
"success": true,
"data": {
"taskId": "veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
"pollingUrl": "https://asyncdata.net/source/veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
"status": "processing",
"message": "Task submitted successfully"
}
}
{
"success": true,
"data": {
"taskId": "veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
"pollingUrl": "https://asyncdata.net/source/veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
"upstreamData": {
"created_at": 1751704074528,
"enhanced_prompt": "A cat is walking on a rainy night, preparing to catch a mouse",
"id": "veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
"images": [
{
"status": "downloading",
"url": "https://tokensceshi.oss-ap-southeast-1.aliyuncs.com/sora/81ecb724-9e01-4f0e-a2ac-0c85802b8841.png"
}
],
"status": "image_downloading"
},
"status": "processing",
"progress": {
"upstreamStatus": "image_downloading",
"retryCount": 0,
"maxRetries": 3
}
}
}
{
"success": true,
"data": {
"taskId": "veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
"upstreamData": {
"status": "video_generating",
"video_generation_id": "f48aea86a9c27d4c8b15612b6c65d08e",
"video_generation_status": "MEDIA_GENERATION_STATUS_ACTIVE"
},
"status": "processing"
}
}
{
"success": true,
"data": {
"taskId": "veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
"status": "completed",
"result": {
"video_url": "https://filesystem.site/cdn/20250705/BFvep0SngrqIrN3yDSFChIXAz2mU0M.mp4",
"video_media_id": "CAUSJGRlNzE5MzRhLTljMDgtNDE1Mi05NWVlLThjOTlhMTZlODUyYxokY2U4ZjNiYmUtNGFmZS00NTExLWI4ZDEtMGM1MTFkM2ZlNGIxIgNDQUUqJDJlNTY3OWUyLWQ2YmQtNGVlZS05ZTUwLWMyMWE0MWU3ZDYzNw"
}
}
}
Status Description
| Status | Description | Next Action |
|---|
processing | Task in progress | Continue polling status |
completed | Generation complete | Retrieve video URL |
failed | Generation failed | Check error information |
HTTP Status Codes
Request parameter error, check parameter format and required fields
Authentication failed, check if API key is correct
Internal server error, please retry later or contact support
{
"success": false,
"message": "Error description",
"error_code": "ERROR_CODE",
"details": {
"field": "Specific error field",
"reason": "Error reason"
}
}
Common Error Codes
| Error Code | Description | Solution |
|---|
INVALID_PROMPT | Invalid prompt | Check prompt length and content |
INVALID_MODEL | Model does not exist | Use supported model names |
QUOTA_EXCEEDED | Quota exceeded | Contact to increase quota |
TASK_NOT_FOUND | Task does not exist | Check task ID |
