Gemini Omni 1.1 Flash Video Edit
- Edit one input video with optional reference images and a text prompt
video_urls: Exactly one directly reachable HTTP/HTTPS MP4, no longer than 10 seconds.image_urls: Optional reference image URLs, up to 10 images. HTTP/HTTPS only. Each image contributes input tokens.quality: Output resolution: 360p, 720p, 1080p, 4k, or auto. Default: auto; auto follows the input video’s resolution.duration: Only auto is accepted and it is the default. Output duration follows the input video.aspect_ratio: Only auto is accepted and it is the default. Output aspect ratio follows the input video.- The model generates synchronized native audio automatically.
- Write negative requirements directly in prompt.
- Asynchronous processing: query task status
- Generated links remain valid for 24 hours; save them promptly.
Authorizations
##All endpoints require authentication using a Bearer Token##
Get your API Key:
Visit the API Key management page to obtain your API Key
Add it to the request header:
Body
Model name, fixed to gemini-omni-1.1-flash-video-edit
gemini-omni-1.1-flash-video-edit "gemini-omni-1.1-flash-video-edit"
Text instruction describing the desired edit and what should remain unchanged.
"Make the lighting warmer while keeping everything else unchanged."
Exactly one directly reachable HTTP/HTTPS MP4, no longer than 10 seconds.
1 elementOptional reference image array, up to 10 images. It may be used with the input video to constrain subjects, style, or elements.
Input requirements:
- HTTP/HTTPS image URLs only
- Supported formats:
png,jpeg,webp
Billing: Every reference image contributes input tokens.
1 - 10 elementsOutput video resolution; default auto.
Supported values:
360p: short side 360720p: short side 7201080p: short side 10804k: short side 2160auto: follows the input video's resolution; default
Choosing a specific resolution can upscale or downscale the output.
Billing: Input and output video tokens are both calculated using the final output resolution; higher resolutions cost more.
360p, 720p, 1080p, 4k, auto "auto"
Only auto is accepted and it is the default. Output duration follows the input video.
auto "auto"
Only auto is accepted and it is the default. Output aspect ratio follows the input video.
auto "auto"
HTTPS callback URL to notify when the task completes
Callback timing:
- Triggered when the task completes (completed), fails (failed), or is cancelled (cancelled)
- Sent after billing is confirmed
Security restrictions:
- HTTPS protocol only
- Callbacks to internal IP addresses are forbidden (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
- URL length must not exceed
2048characters
Callback mechanism:
- Timeout:
10seconds - Up to
3retries on failure (retried1s /2s /4s after each failure respectively) - The callback body format matches the response of the task query endpoint
- A 2xx status code from the callback URL is treated as success; other status codes trigger a retry
"https://your-domain.com/webhooks/video-task-completed"
Response
Video task created successfully
Task creation timestamp
1757169743
Task ID
"task-unified-1757169743-7cvnl5zw"
The model name actually used
"gemini-omni-1.1-flash-video-edit"
The specific type of the task
video.generation.task Task progress percentage (0-100)
0 <= x <= 1000
Task status. The create endpoint returns processing.
pending, processing, completed, failed "processing"
Detailed video task information
The output type of the task
text, image, audio, video "video"
Usage and billing information