Skip to main content
⚠️ This documentation is for legacy custom API, not recommendedPlease see new version: Veo-3.1 Quick Start

Submit Video Task

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

Request Parameters

prompt string required Text description for video generation model string default:“veo3” Model name. Available values:
  • veo3 - Standard version
  • veo3-fast - Fast version
  • veo3-pro - Professional version
  • veo3-pro-frames - Pro version + frame control
images array Array of reference image URLs, maximum 5 enhance_prompt boolean default:false Whether to enhance prompt

Request Examples

cURL Python JavaScript

Response Example

Success Response

Query Task Status

/veo/v1/api/video/status/ Query video generation status

Path Parameters

taskId string required Task ID (returned from submit interface)

Request Examples

cURL Python JavaScript

Response Status

  • Task Submitted
  • Image Downloading
  • Video Generating
  • Generation Completed

Status Description

HTTP Status Codes

200 Success Request successful 400 Client Error Invalid request parameters, 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

Common Error Codes