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 | Endpoint | Description |
|---|---|---|
| Text to video | POST /api/v1/generate | Base generation from a text prompt. |
| Image to video | POST /api/v1/generate | Condition on a reference image — upload it via /api/v1/files/upload and pass the URL. |
| Extend | POST /api/v1/generate | Continue an existing clip |
| Get 4K | POST /api/v1/generate | Upscale the generated video to 4K |
| Get 1080p | POST /api/v1/generate | Render at native 1080p |
| Poll task | GET /api/v1/task/{id}?model=veo-3-1 | Retrieve state and result URLs. |
Input parameters
| Field | Type | Required | Values / example |
|---|---|---|---|
| generationType | select | required | Text to Video, Image to Video, Reference to Video |
| model | select | required | Veo 3.1, Veo 3.1 Fast |
| prompt | textarea | required | A cinematic aerial shot of a coastal town at golden hour, waves crashing on cliffs… |
| imageUrls | image | optional | — |
| aspectRatio | select | required | Auto, 16:9, 9:16 |
| resolution | select | required | 720p, 1080p, 4k |
| duration | select | required | 4s, 6s, 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":{"generationType":"Text to Video","model":"Veo 3.1","prompt":"A paper boat sails down a rain-swollen gutter after a storm, city lights reflecting in the stream. Audio: gentle rain, distant traffic.","aspectRatio":"Auto","resolution":"720p","duration":"8s"}}'