Model Guide

Gemini Omni

Gemini Omni is a fast-turnaround, low-latency video model for prototyping, social short-form content, batch generation, and rapid prompt iteration. This guide follows the shared ToAPIs video task contract so teams can validate workflows before production rollout.

Vendor

Google

Modalities

Video

Price

Pay-as-you-go pricing

Updated

Open in Playground Docs

Model Overview

Quick Answer

Flash-oriented positioning optimized for quick generation, low latency, and high iteration speed.
Well suited to prototyping, social short-form content, and batch output without a heavyweight production setup.
Uses async video task workflows: submit first, then poll task status for results.

Gemini Omni Model Features

Core Section

Core capabilities and practical engineering value

Low-latency output

Built for workflows that need fast feedback and frequent prompt changes.

Short-form batch generation

Fits short videos, multi-variant testing, and social creative production.

Unified video task contract

Reuses the shared ToAPIs video task interface for easier production handoff.

How to Use Gemini Omni API

Set Authorization: Bearer <YOUR_API_KEY>.
Submit a task with model, prompt, aspect_ratio, duration, and resolution.
Capture the returned task_id and poll the video task status endpoint.
Refine prompt, aspect ratio, duration, and other parameters based on output quality.

Key Parameters

Parameter	Type	Required	Default	Range	Description
model	string	Yes	gemini_omni	-	Model identifier. Use the fixed value `gemini_omni`.
prompt	string	Yes	-	-	Main instruction describing the subject, action, scene, and visual style.
aspect_ratio	string	No	16:9	16:9 \| 9:16	Video aspect ratio. Defaults to `16:9`, corresponding to landscape or portrait output.
duration	integer	No	6	6 \| 10	Output duration in seconds. Defaults to `6` and currently supports only `6` and `10`.
resolution	string	No	720P	720P	Output resolution. Currently only `720P` is supported; if omitted, the default value is used.

Common Errors

400 invalid_request_error

Trigger: Request payload misses required fields or has invalid field types.

Fix: Validate model, mode, and input schema before request.

Retry: Retry only after fixing payload; avoid blind retries.

401 authentication_error

Trigger: Missing Authorization header or invalid API key.

Fix: Verify Bearer token format and API key scope.

Retry: Retry after auth fix; rotate key if repeated failures continue.

429 rate_limit_exceeded

Trigger: Request rate, concurrency, or current quota hits upstream rate limiting.

Fix: Apply exponential backoff first, then review request rate, concurrency, and quota usage.

Retry: Use exponential backoff (e.g., 1s/2s/4s) with jitter; if it persists, reduce submission pressure.

500 internal_error

Trigger: Transient upstream error or internal processing failure.

Fix: Capture request id and trigger retry workflow.

Retry: Retry 2-3 times with short delays; escalate if persistent.

FAQ

What is Gemini Omni best for?

It is best suited to prototyping, social short-form video, batch generation, and fast creative iteration where low latency matters.

Image or video model error: invalid apitype: -1

This usually means the request was sent to the wrong endpoint. Image and video models typically do not use the chat endpoint. Instead, submit the documented HTTP task request and poll the task status endpoint for results. Check the actual request code, URL, and payload first.

An image or video task failed, but the user was still charged

Ask the user for the task log or screenshot first and check whether input or output token usage appears. If token accounting shows up, the request was likely sent through a chat endpoint instead of the proper media workflow. Image and video models usually run as async HTTP task APIs: submit the task first, then poll by task id according to the relevant docs.

Mode Notes

Text to Video with Gemini Omni

Generate video directly from prompts for fast script validation and short-form prototyping.

Mode Parameters

modelpromptaspect_ratiodurationresolution

Best Scenarios

Concept validation
Script previs
Social short-form prototyping