Video models
Gemini Omni
On this page
Gemini Omni — high-quality AI video generation.
| modelId | gemini-omni-video, gemini-omni-character, gemini-omni-audio |
| Modality | video |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| Gemini Omni Video | gemini-omni-video | POST /api/v1/generate | prompt |
| Gemini Omni Character | gemini-omni-character | POST /api/v1/generate | image_urls, descriptions |
| Gemini Omni Audio | gemini-omni-audio | POST /api/v1/generate | audio_id, name |
| Poll task | — | GET /api/v1/task/{id}?model=gemini-omni-video | — |
Gemini Omni Video — gemini-omni-video
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | Describe the image you want to generate. Max 20000 characters. (default: A paper crane comes alive on a desk and flies out an open window into the sunset; a soft piano note plays on each wingbeat.) |
| image_urls | string[] | No | Reference images. The base limit is 7; a video uses 2 image slots and each character_id uses 1 image slot. (image URL) |
| video_list | string | No | Optional video input. Only 1 video is allowed and it uses 2 image slots. |
| duration | string | No | Note: when video input is provided, the output duration is determined by the model automatically. This duration parameter will not take effect. (options: 4 | 6 | 8 | 10) (default: 4) |
| aspect_ratio | string | No | Video ratio (options: 16:9 | 9:16) (default: 16:9) |
| resolution | string | No | Output video resolution. Valid values: 720P(default), 1080P, 4k. (options: 720p | 1080p | 4k) (default: 720p) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"gemini-omni-video","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","image_urls":["https://example.com/input.jpg"],"video_list":"example","duration":"4","aspect_ratio":"16:9","resolution":"720p"}}'Gemini Omni Character — gemini-omni-character
| Field | Type | Required | Values / example |
|---|---|---|---|
| character_name | string | No | Input description Max 100 characters. |
| image_urls | string[] | Yes | Upload an image file to use as input for the API (image URL) |
| audio_ids | string | No | Audio ID list. Up to 1 IDs are allowed. |
| descriptions | string | Yes | Character Description Max 20000 characters. (default: Place the provided subject on a windswept coastal clifftop at golden hour, hair and clothing caught in the sea breeze, warm rim light glowing along their edges with a vast shimmering ocean horizon behind.) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"gemini-omni-character","input":{"character_name":"example","image_urls":["https://example.com/input.jpg"],"audio_ids":"example","descriptions":"example"}}'Gemini Omni Audio — gemini-omni-audio
| Field | Type | Required | Values / example |
|---|---|---|---|
| audio_id | string | Yes | The voice to speak the dialogue. |
| name | string | Yes | Input description Max 210 characters. |
| voice_description | string | No | Textarea description Max 20000 characters. (default: Listen to this street recording and identify the city sounds, from rattling trams to buskers and cafe chatter, then describe the neighborhood and time of day they paint.) |
| example_dialogue | string | No | Input description Max 120 characters. |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"gemini-omni-audio","input":{"audio_id":"example","name":"example","voice_description":"example","example_dialogue":"example"}}'