> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# gemini-omni-flash-preview

> API usage guide for gemini-omni-flash-preview.

**Model ID**

```bash theme={null}
gemini-omni-flash-preview
```

**Calling method:** async

# Gemini Omni Flash API Usage Guide

## Overview

**Gemini Omni Flash** generates 720p video from a text prompt, optionally guided by reference images and/or an input video. It produces 24 FPS video at durations of 3-10 seconds (1-second increments) in 16:9 or 9:16.

All generated videos are marked with invisible **SynthID** watermarking and **C2PA** content credentials.

## Authentication

Include your API key in the Authorization header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Submit a request

### Endpoint

```
POST https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests
```

### Example

```bash theme={null}
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-omni-flash-preview",
    "payload": {
      "prompt": "A majestic eagle soaring through a mountain landscape at sunset",
      "reference_image": ["https://example.com/reference1.jpg"],
      "durationSeconds": 5,
      "aspectRatio": "16:9"
    }
  }'
```

### Request parameters

Parameter names match our Veo video models, so a single integration works across both.

| Parameter         | Type               | Required | Description                                                                                                                                                                   |
| ----------------- | ------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`          | string             | Yes      | Text description of the video to generate.                                                                                                                                    |
| `reference_image` | string/array       | No       | Up to 5 reference image URLs (image-to-video).                                                                                                                                |
| `video`           | string/array       | No       | Up to 3 input video URLs (MP4). A single video is edited (output follows its length); multiple videos are combined by the model.                                              |
| `durationSeconds` | integer / `"auto"` | No       | Video length in seconds, 3-10, or `auto` (default) to let the model decide. Use `auto` when a `video` input is provided — the edited output follows the source clip's length. |
| `aspectRatio`     | enum               | No       | `auto` (default), `16:9`, or `9:16`. With a `video` input, `auto` follows the source clip.                                                                                    |
| `resolution`      | enum               | No       | `720p` (only supported value in this preview).                                                                                                                                |

## Check status

```bash theme={null}
curl "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/{request_id}" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

On success, `outcome.media_urls[0].url` is the generated video (720p mp4), with `thumbnail_image_url` alongside.

## Pricing

* **Video output (720p): \$0.10 per second** of generated video — same rate with or without audio, and independent of aspect ratio.
* Input references (text/image/video) are billed at \$1.50 per 1M tokens (Gemini tokenization).

## Capabilities & limits (public preview)

* Duration: 3-10s (1s increments) or `auto`; Resolution: 720p; Aspect ratio: `auto`, 16:9 or 9:16
* With a `video` input the output follows the source clip — set `durationSeconds` to `auto` (or omit it); an explicit duration that doesn't match the source is rejected by the model
* Up to 5 reference images; input video up to 10s
* Not yet supported: audio references, last-frame guidance, scene extension