Create videos using Google Veo models with text prompts and optional reference images
POST /v1/video/create
| Model | Description |
|---|---|
| veo2 | Veo 2 base model |
| veo2-fast | Veo 2 fast generation |
| veo2-fast-frames | Veo 2 fast with frame input (supports up to 2 images for first/last frame) |
| veo2-fast-components | Veo 2 fast with component images (supports up to 3 images as video elements) |
| veo2-pro | Veo 2 professional quality |
| veo2-pro-components | Veo 2 pro with component images |
| veo3 | Veo 3 base model |
| veo3-fast | Veo 3 fast generation |
| veo3-fast-frames | Veo 3 fast with frame input |
| veo3-frames | Veo 3 with frame input |
| veo3-pro | Veo 3 professional quality |
| veo3-pro-frames | Veo 3 pro with frame input (supports 1 image as first frame) |
| veo3.1 | Veo 3.1 base model |
| veo3.1-fast | Veo 3.1 fast generation |
| veo3.1-pro | Veo 3.1 professional quality |
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | The model to use for video generation |
| prompt | string | Yes | Text prompt describing the video to generate |
| images | array | No | Reference images. For veo2-fast-frames: up to 2 images (first/last frame). For veo3-pro-frames: 1 image (first frame). For veo2-fast-components: up to 3 images (video elements) |
| aspect_ratio | string | No | Video aspect ratio. Only supported by veo3 models. Options: 16:9 or 9:16 |
| enable_upsample | boolean | No | Enable video upsampling for higher quality |
| enhance_prompt | boolean | No | Enable automatic prompt enhancement. Since Veo only supports English prompts, enable this to automatically translate Chinese prompts to English |
| Field | Type | Description |
|---|---|---|
| id | string | Unique task identifier for querying video status |
| status | string | Current task status (e.g., pending, processing, completed) |
| status_update_time | integer | Timestamp of the last status update |
| enhanced_prompt | string | The enhanced prompt if enhance_prompt was enabled |