veo-3.1
Capability: 1080p · up to 8s · text + image init · async via tasks API
Pricing: per second, standard tier (live rate)
Veo 3.1 is Google’s text-to-video flagship. The thing it does best is
natural-world footage with coherent physics — water, foliage, animal
motion, weather. For studio / cinematic shots Sora 2 Pro often has
the edge; for “drone over a forest” / “tide coming in” / “wildlife”
type briefs, Veo’s the right call.
Submit
Body parameters
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
model | string | yes | — | veo-3.1 |
prompt | string | yes | — | English-tuned. |
duration_seconds | integer | yes | — | 1–8. |
resolution | string | no | 1080p | Supported: 720p, 1080p. |
aspect_ratio | string | no | 16:9 | 16:9 / 9:16 / 1:1. |
seed | integer | no | — | Reproducibility. |
image_init | string | no | — | URL of init image. |
Submit response
Poll for completion
Recommended cadence: 2s for first 60s, then 5s up to 180s. Query is free.Code examples
Errors
| Code | Trigger | Billed? |
|---|---|---|
| 400 | Body validation (duration > 8, resolution unsupported) | No |
| 401 / 402 / 403 | Auth / wallet / scope | No |
| 451 | Prompt blocked by upstream safety | No |
| 5xx | Upstream issue | No (auto-retry) |
When to use
- Natural-world footage (landscape, weather, wildlife, water).
- Physics-coherent motion at typical drone / handheld scales.
- For lower fidelity at faster turnaround, see Veo 3.1 Fast.
- For studio / cinematic 1080p, see Sora 2 Pro.
- For lower cost, see Seedance 2.0.
Limits
| Limit | Value |
|---|---|
| Max duration | 8s |
| Min duration | 1s |
| Resolutions | 720p, 1080p |
| Aspect ratios | 16:9, 9:16, 1:1 |
| Supports image init | Yes |
| Typical latency for 5s clip | 60-120s |
| Async via tasks API | Yes |