Gemini Video Generation
Generate videos from the same/gemini/video/generate entry using Veo or Omni. The two families share prompt / action / aspectRatio, but do not mix their image-count or duration rules. Editing (upsample, extend, reshoot, object insert/remove) is Veo-only.
Supported Models
Features
Text-to-Video
Create videos from text prompts with
action: "text2video"Image-to-Video
Veo: 1–2 frames (start / start+end). Omni: 1–7 reference images
Ingredients-to-Video
Veo only: 1–3 guide images with
action: "ingredients2video"Omni Flash
Same generate endpoint with
model: "omni-flash" — duration 3–10sUpsample & Extend
Upscale to 1080p/4K, generate GIFs, or extend video duration (Veo)
Reshoot & Object Edit
Change camera motion, or insert/remove objects with masks (Veo)
How to Use
1
Generate a video
Call
POST /gemini/video/generate with your prompt and model. You’ll receive a taskId.2
Poll for results
Use
GET /gemini/task/result?taskId=xxx to poll until status is completed. The result contains the video URL.3
Enhance (optional, Veo)
Use the returned
videoId to upscale, extend, reshoot, or edit objects. Do not use /video/generate for upsample / GIF.Generate Rules
Shared fields:prompt (required, English recommended), action, aspectRatio (16:9 default / 9:16).
Veo (veo31_fast / veo31_quality)
Three-image (ingredients) notes:
- Keep
model=veo31_fast+action=ingredients2video(legacyveo31_fast_ingredientsis still accepted) veo31_fastitself supports at most 2 start/end frames; 3 images are routed server-side to Veo 3.1 reference-image- Upstream 3-image jobs only accept 8 seconds;
4/6returns 400
veo3_fast / veo3_quality map to veo31_*. Optional generate_audio and resolution (720p / 1080p) apply to Veo only.
Omni (omni-flash)
Omni does not support
ingredients2video. generate_audio / resolution are ignored.
Available Endpoints
Generation
Post-Processing
Object Editing
Task Management
Video and Image share the same polling endpoint — see Get Task Result.Explore the API Documentation
- Generate Video — Text-to-video, image-to-video, ingredients-to-video (Veo / Omni)
- Upsample Video — Upscale to 1080p/4K or generate GIF
- Expand Prompt — Enhance prompts for better results
- Reshoot Video — Change camera motion
- Extend Video — Extend video duration
- Insert Object — Add objects to video
- Remove Object — Remove objects from video
- Get Task Result — Shared poll for video & image tasks