curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-flash-preview-official",
"prompt": "A blue pump bottle slowly rotates in a clean white studio, commercial product video",
"duration": 6,
"aspect_ratio": "9:16",
"resolution": "720p",
"image_urls": ["https://example.com/reference.jpg"]
}'
{
"id": "video_01JZEXAMPLE",
"object": "generation.task",
"model": "gemini-omni-flash-preview-official",
"status": "queued",
"created_at": 1779247407
}
Gemini Omni Official
Gemini Omni Flash Video Generation
Generate or edit videos with Gemini Omni Flash using text, up to 10 reference images, or up to 3 input videos
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-flash-preview-official",
"prompt": "A blue pump bottle slowly rotates in a clean white studio, commercial product video",
"duration": 6,
"aspect_ratio": "9:16",
"resolution": "720p",
"image_urls": ["https://example.com/reference.jpg"]
}'
{
"id": "video_01JZEXAMPLE",
"object": "generation.task",
"model": "gemini-omni-flash-preview-official",
"status": "queued",
"created_at": 1779247407
}
Note for users in mainland China: Please use
https://toapis.cn as the API endpoint (Base URL). Replace https://toapis.com with https://toapis.cn in the examples in this document.- Use
gemini-omni-flash-preview-officialin themodelfield - Supports text-to-video, image/reference-to-video, and video editing
- Supports up to 10 reference images and up to 3 input videos; images and videos can be combined in one request
- Video duration is limited to 10 seconds; the Playground offers 4 / 6 / 8 / 10 second presets
- Only
720presolution is supported; both16:9and9:16aspect ratios are available - Async task API: submit a task, then query by task ID
This page documents
gemini-omni-flash-preview-official. The platform routes it through the Vertex AI Interactions API, not the Vertex AI Publisher Model predictLongRunning endpoint. It remains separate from the legacy gemini-omni-flash / gemini_omni_flash model and does not change that model’s routing or parameters.Upload local images with the Upload Image API and local videos with the Upload Video API first, then pass the returned URLs. Do not pass base64 media data directly.
Authorizations
string
required
Use Bearer Token authentication:
Authorization: Bearer YOUR_API_KEY
Body
string
default:"gemini-omni-flash-preview-official"
required
Model name. Use
gemini-omni-flash-preview-official.string
required
Text prompt for video generation.
integer
default:"6"
Video duration in seconds. The maximum is
10; the Playground offers 4, 6, 8, and 10 second presets.string
default:"16:9"
Video aspect ratio:
16:9landscape9:16portrait
string
default:"720p"
Video resolution:
720pdefault resolution- Only
720pis supported; Veo-specific parameters are not accepted
string[]
Optional reference image URL array with up to
10 items. Omit it for text-to-video. Can be combined with video_list, for example to attach reference images when extending a video.object[]
Optional input videos for video editing, with up to
3 items. Each object must contain video_url, for example { "video_url": "https://example.com/input.mp4" }. HTTPS URLs, data URIs, and platform-uploaded video URLs are supported. Each downloaded input video is limited to 50 MB. Can be combined with image_urls for mixed image-plus-video input.object
Optional Interactions generation controls. Supported keys include
temperature (0.0–2.0), topP / top_p (0.0–1.0), candidateCount / candidate_count, previous_interaction_id, and task (text_to_video, image_to_video, reference_to_video, edit, or extend). When task is omitted, the platform does not invent a default; the upstream model infers the mode from the prompt and media. For edit (or video inputs without an explicit non-edit task), do not rely on aspect_ratio; the platform omits it for that path because upstream rejects aspect ratio on edit tasks. extend continues a source video supplied through video_list, cannot be combined with previous_interaction_id, and also omits aspect_ratio.Response
string
Task ID for status polling.
string
Object type, usually
generation.task.string
Model name used for the request.
string
Task status:
queued, in_progress, completed, or failed.integer
Task creation timestamp.
string
Generated video URL when the task completes.
Examples
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-flash-preview-official",
"prompt": "A blue pump bottle slowly rotates in a clean white studio, commercial product video",
"duration": 6,
"aspect_ratio": "9:16",
"resolution": "720p",
"image_urls": ["https://example.com/reference.jpg"]
}'
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-flash-preview-official",
"prompt": "Turn the daytime scene into a rainy night while preserving the camera motion",
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "720p",
"video_list": [{"video_url": "https://example.com/input.mp4"}],
"metadata": {"temperature": 1.0, "topP": 0.95}
}'
duration is the continuation length in seconds, about 10 when omitted; the output is the source video plus the continuation):
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-flash-preview-official",
"prompt": "Continue the same scene and camera motion",
"duration": 5,
"video_list": [{"video_url": "https://example.com/input.mp4"}],
"metadata": {"task": "extend"}
}'
{
"id": "video_01JZEXAMPLE",
"object": "generation.task",
"model": "gemini-omni-flash-preview-official",
"status": "queued",
"created_at": 1779247407
}
Query Task
The generation endpoint returns a task ID. Use the common video task status endpoint to fetch status and results:curl --request GET \
--url https://toapis.com/v1/videos/generations/{task_id} \
--header "Authorization: Bearer YOUR_API_KEY"