Gemini Omni 1.1 Flash Video Extend
- Extend one input video using optional reference images and a text prompt
video_urls: Exactly one directly reachable HTTP/HTTPS MP4, no longer than 30 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: Seconds appended after the input video. Integer from 3 to 10; default 3.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.
- Billing scope: Output-video usage is calculated from the appended seconds. The input video, reference images, prompt, and model reasoning also contribute to usage; final charges follow actual token usage.
- Input-video cost and
quality: Input video tokens are calculated using the selected output resolution, not the source video’s original resolution.
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-extend
gemini-omni-1.1-flash-video-extend "gemini-omni-1.1-flash-video-extend"
Text prompt describing what should happen after the input video ends.
"The person keeps walking and slowly exits the frame."
Exactly one directly reachable HTTP/HTTPS MP4, no longer than 30 seconds.
1 elementOptional reference image array, up to 10 images. It may be used with the video being extended 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 elementsAppended video duration in seconds; default 3.
Notes:
- Accepts any integer from
3to10 - Specifies how many seconds are generated after the input video, not the total output duration
- Total output duration = input video duration +
duration - Appended duration directly affects billing
3 <= x <= 103
Output 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 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-extend"
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