Skip to main content
POST
  1. After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
  2. Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.
gemini-omni-1.1-flash generates videos from a text prompt, optional first and last frames, ordinary reference images, or one reference video.

Models

  • gemini-omni-1.1-flash - Text-to-video, first/last-frame generation, reference image generation, and reference-video generation

Input modes

  • Text to video: Send prompt and optional generation settings
  • First/last frame video: Send one or two images in image_urls
  • Reference image video: Send up to seven images in reference_image_urls
  • Reference video: Send one video from three to ten seconds in reference_video_urls, optionally together with up to five reference images

Required parameters

  • prompt: Text prompt describing the scene, motion, style, camera behavior, and other generation instructions

Optional parameters

  • image_urls: First-frame and optional last-frame image URL array. At most 2 images are allowed
  • reference_image_urls: Ordinary reference image URL array. At most 7 images are allowed, or 5 when a reference video is also provided
  • reference_video_urls: Reference video URL array. At most 1 video is allowed and its duration must be from 3 to 10 seconds, inclusive
  • resolution: 360p, 720p, 1080p, or 4k. Default is 720p
  • duration: 4, 6, 8, or 10 seconds. Default is 8. This field does not affect output duration when a reference video is provided
  • aspect_ratio: 16:9 or 9:16. Default is 16:9
  • callback_url: Optional webhook URL for completion notifications

Examples

Text to Video

First and Last Frames

Reference Images

Reference Video

Notes

  • image_urls cannot be combined with reference_image_urls or reference_video_urls
  • Use public HTTPS media URLs, or upload files through the playground before submitting
  • The response returns a task_id; query task status to retrieve generated video files

Authorizations

Authorization
string
header
required

All API endpoints require Bearer Token authentication

Get your API Key:

Visit the API Key Management Page to get your API Key

Add it to the request header:

Body

application/json
model
enum<string>
required

Gemini Omni 1.1 Flash model identifier

Available options:
gemini-omni-1.1-flash
input
object
required
callback_url
string<uri>

Webhook callback URL for result notifications

Example:

"https://your-domain.com/callback"

Response

200 - application/json

Task submitted successfully

code
integer
required
Example:

200

data
object
required
message
string
Example:

"success"