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

# Gemini Omni 1.1 VIP

> VIP supports text-to-video, image-to-video and reference video. Choose 4 / 6 / 8 / 10 seconds and 360p / 720p / 1080p / 4k, defaulting to 6 seconds / 720p. Omit duration with reference video.

VIP supports text-to-video, image-to-video and reference video. Choose 4 / 6 / 8 / 10 seconds and 360p / 720p / 1080p / 4k, defaulting to 6 seconds / 720p. Omit duration with reference video.

<Note>Use your platform API key, not a supplier key. In mainland China, use [https://toapis.cn](https://toapis.cn) as the Base URL.</Note>

[Standard](./generation-1-1) | [Official documentation](../gemini-omni-1.1-flash-preview-official/generation)

## Request parameters

<ParamField header="Authorization" type="string" required>
  `Bearer YOUR_API_KEY`
</ParamField>

<ParamField body="model" type="string" required>
  `gemini-omni-1.1-flash-preview-vip`
</ParamField>

<ParamField body="prompt" type="string" required>Required video description.</ParamField>
<ParamField body="duration" type="integer" default="6">VIP: 4 / 6 / 8 / 10 seconds, default 6. With VIP video\_urls, omit both duration and seconds.</ParamField>
<ParamField body="resolution" type="string" default="720p">VIP: 360p / 720p / 1080p / 4k, default 720p, case-insensitive.</ParamField>
<ParamField body="aspect_ratio" type="string" default="16:9">16:9 or 9:16, default 16:9.</ParamField>
<ParamField body="image_urls" type="string[]">VIP frame mode requires 1 image; reference accepts 1 or 3. Two-frame input is unsupported. Omit generation\_type when no images are provided.</ParamField>
<ParamField body="generation_type" type="string">VIP only. frame uses a first frame; reference uses reference images. If omitted, 1 image selects frame and 3 select reference.</ParamField>
<ParamField body="video_urls" type="string[]">VIP only. At most 1 public HTTP(S) video URL, optionally with images. Omit duration and seconds when providing a reference video. Output duration is determined by the generated result and is not guaranteed to match the source video.</ParamField>

<Warning>Upload local media first to obtain public URLs. Do not send base64 or local file paths.</Warning>

## Request examples

<Tabs>
  <Tab title="VIP">
    ```bash theme={null}
    curl https://toapis.com/v1/videos \
      -H 'Authorization: Bearer YOUR_API_KEY' \
      -H 'Content-Type: application/json' \
      -d '{
        "model": "gemini-omni-1.1-flash-preview-vip",
        "prompt": "A cinematic tracking shot through a sunlit city",
        "duration": 8,
        "resolution": "360p",
        "aspect_ratio": "9:16",
        "generation_type": "reference",
        "image_urls": [
          "https://example.com/a.png",
          "https://example.com/b.png",
          "https://example.com/c.png"
        ]
      }'
    ```
  </Tab>

  <Tab title="VIP VIDREF">
    ```bash theme={null}
    curl https://toapis.com/v1/videos \
      -H 'Authorization: Bearer YOUR_API_KEY' \
      -H 'Content-Type: application/json' \
      -d '{
        "model": "gemini-omni-1.1-flash-preview-vip",
        "prompt": "The same scene at night with neon lights",
        "resolution": "4k",
        "aspect_ratio": "16:9",
        "generation_type": "reference",
        "image_urls": ["https://example.com/image.png"],
        "video_urls": ["https://example.com/video.mp4"]
      }'
    ```
  </Tab>
</Tabs>

## Retrieve a task

Submission returns a platform task id. Poll GET /v1/videos/{id} and retrieve the video result on completion. Do not use supplier task IDs or supplier polling endpoints.

```bash theme={null}
curl https://toapis.com/v1/videos/YOUR_TASK_ID \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

<ResponseExample>
  ```json theme={null}
  {
    "id": "vid_example",
    "object": "generation.task",
    "model": "gemini-omni-1.1-flash-preview-vip",
    "status": "queued",
    "created_at": 1789600000
  }
  ```
</ResponseExample>

## Invalid parameters

Correct invalid resolution or duration, image counts inconsistent with the VIP mode, multiple reference videos, or video references combined with duration before resubmitting.