Skip to main content

​
Submit Video Task

​
/veo/v1/api/video/submit
Submit a video generation task

​
Request Parameters

​
prompt
string
required
Text description for video generation
​
model
string
default:"veo3"
Model name. Available options:
  • veo3 - Standard version
  • veo3-fast - Fast version
  • veo3-pro - Professional version
  • veo3-pro-frames - Professional version + frame control
​
images
array
Array of reference image URLs, maximum 5 images
​
enhance_prompt
boolean
default:false
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

​
taskId
string
required
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"
  }
}

​
Status Description

StatusDescriptionNext Action
processingTask in progressContinue polling status
completedGeneration completeRetrieve video URL
failedGeneration failedCheck error information

​
HTTP Status Codes

​
200
Success
Request successful
​
400
Client Error
Request parameter error, check parameter format and required fields
​
401
Authentication Error
Authentication failed, check if API key is correct
​
500
Server Error
Internal server error, please retry later or contact support

​
Error Response Format

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

​
Common Error Codes

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