Video models
Veo 3.1
On this page
State-of-the-art text & image to video with native audio.
| modelId | veo-3-1 |
| Modality | video |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| Default | veo-3-1 | POST /api/v1/generate | prompt, imageUrls, aspectRatio, resolution, duration |
| Poll task | — | GET /api/v1/task/{id}?model=veo-3-1 | — |
Input parameters
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | Text value (default: A paper boat sails down a rain-swollen gutter after a storm, city lights reflecting in the stream. Audio: gentle rain, distant traffic.) |
| imageUrls | string[] | Yes | Image URL |
| aspectRatio | string | Yes | Options: Auto | 16:9 | 9:16 (default: Auto) |
| resolution | string | Yes | Options: 720p | 1080p | 4k (default: 720p) |
| duration | string | Yes | The duration of the generated video, in seconds. (options: 4s | 6s | 8s) (default: 8s) |
Example request
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"veo-3-1","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","aspectRatio":"Auto","resolution":"720p","duration":"8s"}}'