{
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Required: Text description of the video to generate. Be specific and descriptive for best results."
},
"model": {
"type": "string",
"enum": [
"veo-3.1",
"veo-3.1-fast"
],
"default": "veo-3.1-fast",
"description": "Model to use. \"veo-3.1\" for full-featured high quality, \"veo-3.1-fast\" for speed-optimized (default). Note: reference_images only work with veo-3.1."
},
"duration": {
"type": "number",
"default": 8,
"description": "Video duration in seconds (default: 8)"
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"9:16"
],
"default": "16:9",
"description": "Aspect ratio. \"16:9\" for landscape/YouTube (default), \"9:16\" for vertical/mobile/TikTok"
},
"resolution": {
"type": "string",
"enum": [
"1080p",
"720p"
],
"default": "1080p",
"description": "Video resolution (default: 1080p)"
},
"image": {
"type": "string",
"description": "Optional: Starting image URL (1280x720 or 720x1280) to animate into video"
},
"last_frame": {
"type": "string",
"description": "Optional: Ending image URL for smooth transition. Requires \"image\" to be set."
},
"reference_images": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: Array of 1-3 image URLs for style guidance (e.g., [\"https://example.com/ref1.jpg\", \"https://example.com/ref2.jpg\"]). Only works with veo-3.1 model, 16:9 aspect ratio, and 8-second duration."
},
"generate_audio": {
"type": "boolean",
"default": true,
"description": "Whether to generate audio for the video (default: true)"
},
"negative_prompt": {
"type": "string",
"description": "Optional: What to avoid in the video (e.g., \"blurry, low quality\")"
},
"seed": {
"type": "number",
"description": "Optional: Seed for reproducible results"
}
},
"required": [
"prompt"
]
}