Google Veo / Veo 3.1 Fast / Image to video
google_veo/veo-3.1-fast-generate-preview/image_to_video
Async
Animate a static image into a short video.
Parameters
| Name | Type | Required | Description | Allowed values | Bundle dim. |
|---|---|---|---|---|---|
| mode | string | no | Internal task-type marker (matches the method code). | text_to_video, image_to_video | — |
| prompt | string | yes | Text prompt describing the desired output. | — | — |
| resolution | string | no | — | 720p, 1080p, 4K | — |
| aspect_ratio | string | no | — | 16:9, 9:16, 1:1 | — |
| callback_url | string | no | Webhook URL invoked when async task completes. | — | — |
| videos_count | integer | no | — | — | — |
| input_image_url | string | yes | — | — | — |
| duration_seconds | integer | no | Video duration in seconds. Pricing is PER_SECOND, so the duration is NOT part of the bundle key — total cost = perSecondUnits × duration. | 4, 6, 8, 10, 12 | — |
Example request
{
"provider": "google_veo",
"model": "veo-3.1-fast-generate-preview",
"method": "image_to_video",
"params": {
"prompt": "Camera slowly pans around the scene with cinematic lighting",
"resolution": "1080p",
"aspect_ratio": "16:9",
"input_image_url": "https://example.com/start-frame.jpg",
"duration_seconds": 8
}
}Example response
null