API protocol

Veo: parameters, scenarios and API guide

Preview guide

Paste into an AI assistant to help with integration. Documentation and examples only; no real credentials.

Preview guide

Veo: parameters, scenarios and API guide

Direct answerGemini API Veo 3.1 Preview (generate/fast/lite-preview) was shut down on 2026-10-22; this does not imply all Google Cloud Veo GA models are removed. Site aliases such as veo3-pro and *-frames lack an accepted official-ID mapping.

Updated · Reviewed

Purpose and workflows

For shot creation and image-guided video. Site veo2/veo3/veo3.1 and fast/pro/frames names are catalog aliases, not automatically official API IDs.

This guide checks the site request contract; it does not claim paid generation acceptance for every scenario. Use the exact model, group and available endpoint shown in the marketplace. Replace example.com media and placeholder task IDs. Confirm a minimal request before adding references and advanced parameters. Consult marketplace pricing and actual billing for charges.

Models and endpoints

veo3.1, veo3-pro, veo2-fast, veo3-pro-frames, veo3, veo3-fast, veo2, veo2-fast-frames, veo3-fast-frames, veo3-frames, veo2-pro

This family has no published executable site generation request here. The guide retains selection and migration information; a catalog entry is not endpoint acceptance.

Reference media formats

MediaFieldsEncoding and transportPreparation and limits
Images / frames—No executable site media-input contract is published for this family. Do not infer URL/Base64 support from official or other-family APIs.Confirm the exact model and available endpoint. Disk paths, data URIs, raw Base64 and task IDs are not interchangeable.
Reference / edit video—No executable site media-input contract is published for this family. Do not infer URL/Base64 support from official or other-family APIs.Confirm the exact model and available endpoint. Disk paths, data URIs, raw Base64 and task IDs are not interchangeable.
Reference audio—No executable site media-input contract is published for this family. Do not infer URL/Base64 support from official or other-family APIs.Confirm the exact model and available endpoint. Disk paths, data URIs, raw Base64 and task IDs are not interchangeable.

Parameters and combinations

  • Gemini API Veo 3.1 Preview (generate/fast/lite-preview) was shut down on 2026-10-22; this does not imply all Google Cloud Veo GA models are removed. Site aliases such as veo3-pro and *-frames lack an accepted official-ID mapping.
  • Accepted unified video examples are not currently published. Review the family and requirements without inventing endpoints/model suffixes or restoring withdrawn Remix examples.
  • Confirm the exact marketplace model, effective endpoint, group access and task response. Acceptance does not mean a finished video.
  • Verify text generation, image input, output settings and terminal status before independently testing editing, extension, sound and multiple references.
FieldTypeUse and constraints
modelofficial ID mappingCloud docs distinguish veo-3.1-generate-001, veo-3.1-fast-generate-001 and veo-3.1-lite-generate-001. Site veo3.1 cannot automatically be mapped to any one of them.
prompt / image / last frame / reference imagesofficial capabilitiesOfficial 3.1 Generate supports text, image, first/last frames and asset references. Capability names are not site JSON fields; site media structures remain unaccepted.
duration / resolution / aspect ratioofficial capabilitiesOfficial 3.1 Generate supports 4/6/8s, with references requiring 8s; 16:9/9:16 and 720p/1080p/4K. These are not site alias guarantees and do not apply to Veo 2/3.
audio / extension / output countofficial capabilitiesOfficial 3.1 Generate supports sound and extension with up to four outputs, but no standalone audio input. Do not assume official multi-output or extension requests work on this service.

Scenarios and code examples

Check whether the exact model has an available endpoint and a published parameter contract. Verify minimal text input, a single image, output settings and terminal task results in that order. Do not construct model suffixes from another platform, or reuse another family’s prompt/content/contents schema. Unpublished scenarios have no submit action or executable sample.

Task results and downloads

Save id or task_id from submission. Poll GET /v1/videos/{task_id}: queued / in_progress lead to completed or failed. Read video_url on completion (some responses also expose metadata.url). Resolve relative URLs against the API origin. The site /content endpoint uses your site key; external downloads must not receive that key. Download expiring results promptly. Resume GET after a timeout rather than automatically repeating POST.

Complete unified video Python / JavaScript polling and download examples

Troubleshooting

SymptomCheck
Image validation / URI errorEnsure a video or task ID was not placed in an image field; check the URL returns media
Unsupported content type / fieldCheck the exact family and content/contents/input schema; voice_id cannot be an audio URL
400 conflicting fieldsCheck prompt/input, frames/references, and seconds/response_format exclusivity
HTTP success but task failedRetain the site task ID, time, model, domain and redacted request; submission 200 is not output success
404 or inaccessible taskCheck domain, key access and task type; do not use IDs from another site or the official API
Local file cannot be fetchedUse a supported upload flow or a reachable HTTPS media URL

Sources and scope

Google video documentation

Veo 3.1 Cloud model specifications

Use cases

  • Choose video models and media formats
  • Diagnose request and task failures

API protocols

  • /v1/models

FAQ

Does a task ID prove generation succeeded?

No. Save the site task ID, poll to a successful terminal state and verify the result. Inspect failures instead of automatically creating a new task.

Can I put a local image, video or WAV path in JSON?

No. URL fields require reachable media, not localhost, disk paths or browser-login links. Kling PCM WAV requires an enabled multipart voice endpoint (both sites returned 404 on 2026-11-15). Follow each family’s asset workflow for other media.

Can parameters and task IDs be reused across models?

Do not assume compatibility. Check the exact model, endpoint, casing, media role and exclusive fields. Editing, drafts and voices require accessible successful tasks of the correct kind. Official capabilities are not evidence of site acceptance.

Official sources

  1. Google video documentation Official
  2. Veo 3.1 Cloud model specifications Official