Google Videos Generate
google-videos-generateRead-only
Generate videos from text prompts or reference images/videos using Google Veo. Optionally wait for completion and download the generated videos.
Instructions
Generate videos using Google GenAI (Veo). Can optionally wait for completion and download generated videos to MEDIA_GEN_DIRS.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | No | Text prompt that describes the video to generate (max 32K chars). Required unless an input image/video is provided. | |
| input_reference | No | Optional image reference (image-to-video): HTTP(S) URL, base64 / data URL, or file path under MEDIA_GEN_DIRS. | |
| input_reference_mime_type | No | Optional override for input image MIME type (e.g. image/jpeg). Useful when input_reference is raw base64 without a data URL header. | |
| input_video_reference | No | Optional input video reference (video extension): HTTP(S) URL or file path under MEDIA_GEN_DIRS. Mutually exclusive with input_reference. | |
| model | No | Google video model id (default: veo-3.1-generate-001). | veo-3.1-generate-001 |
| number_of_videos | No | Number of videos to generate (default: 1). | |
| aspect_ratio | No | Aspect ratio for the generated video. | |
| duration_seconds | No | Video duration in seconds (provider/model-dependent). | |
| person_generation | No | Controls whether people are allowed in the generated video. | |
| wait_for_completion | No | If true, poll the operation until done (then optionally download). Default: true. | |
| timeout_ms | No | Max time to wait for completion when wait_for_completion is true (default: 900000). | |
| poll_interval_ms | No | Polling interval when wait_for_completion is true (default: 10000). | |
| download_when_done | No | When waiting, whether to download generated videos to MEDIA_GEN_DIRS[0]. Defaults to true when wait_for_completion=true, otherwise false. | |
| tool_result | No | Controls content[] shape when downloading: 'resource_link' (default) emits ResourceLink items, 'resource' emits EmbeddedResource blocks with base64 blob. | resource_link |
| response_format | No | Controls structuredContent video fields: 'url' (default) prefers video.uri, 'b64_json' prefers video.videoBytes. | url |