> ## 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 Flash

> Генерация и редактирование видео Gemini Omni Flash с текстом, до 10 референсных изображений или до 3 входных видео

> [!NOTE]
>
> **Для пользователей из материкового Китая:** используйте `https://toapis.cn` в качестве эндпоинта (Base URL). Замените `https://toapis.com` на `https://toapis.cn` во всех примерах этого документа.

* Укажите `gemini-omni-flash-preview-official` в поле `model`
* Поддерживает text-to-video, image/reference-to-video и редактирование видео
* Поддерживает до 10 референсных изображений и до 3 входных видео; изображения и видео можно передавать вместе в одном запросе
* Максимальная длительность видео — 10 секунд; в Playground доступны пресеты 4 / 6 / 8 / 10 секунд
* Поддерживается только разрешение `720p`; доступны форматы `16:9` и `9:16`
* Асинхронный API задач: после отправки используйте ID задачи для проверки статуса

> [!NOTE]
>
> Эта страница описывает `gemini-omni-flash-preview-official`. Платформа вызывает её через Vertex AI Interactions API, а не через Vertex AI Publisher Model `predictLongRunning`. Она отделена от устаревшей модели `gemini-omni-flash` / `gemini_omni_flash`.

> [!WARNING]
>
> Сначала загрузите локальные изображения через [Upload Image API](https://docs.toapis.com/docs/ru/api-reference/uploads/images.md), а видео через [Upload Video API](https://docs.toapis.com/docs/ru/api-reference/uploads/videos.md), затем передайте полученные URL. Не передавайте media в base64 напрямую.

## Authorizations

**Authorization** `string` *required*

Используйте Bearer Token:

```
Authorization: Bearer YOUR_API_KEY
```

## Body

**model** `string` *required* (default: gemini-omni-flash-preview-official)

Название модели. Используйте `gemini-omni-flash-preview-official`.

**prompt** `string` *required*

Текстовый prompt для генерации видео.

**duration** `integer` (default: 6)

Длительность видео в секундах. Максимум — `10`; в Playground доступны пресеты `4`, `6`, `8`, `10`.

**aspect\_ratio** `string` (default: 16:9)

Соотношение сторон:

* `16:9` landscape
* `9:16` portrait

**resolution** `string` (default: 720p)

Разрешение видео:

* `720p` по умолчанию
* Поддерживается только `720p`; параметры Veo не принимаются

**image\_urls** `string[]`

Необязательный массив URL референсных изображений, до `10` элементов. Не передавайте его для text-to-video. Можно совмещать с `video_list`, например чтобы приложить референсные изображения при продлении видео.

**video\_list** `object[]`

Необязательные входные видео для редактирования, до `3` элементов. Каждый объект должен содержать `video_url`. Можно совмещать с `image_urls` для смешанного ввода «видео + референсные изображения».

**metadata** `object`

Необязательные параметры генерации: `temperature`, `topP` / `top_p`, `candidateCount` / `candidate_count`, `previous_interaction_id` и `task` (`text_to_video`, `image_to_video`, `reference_to_video`, `edit` или `extend`). `extend` продолжает исходное видео, переданное через `video_list`, несовместим с `previous_interaction_id` и также не передает `aspect_ratio`.

## Response

**id** `string`

ID задачи для проверки статуса.

**object** `string`

Тип объекта, обычно `generation.task`.

**model** `string`

Название модели, использованной в запросе.

**status** `string`

Статус задачи: `queued`, `in_progress`, `completed`, `failed`.

**created\_at** `integer`

Временная метка создания задачи.

**video\_url** `string`

URL сгенерированного видео после завершения задачи.

## Examples

```bash cURL theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-omni-flash-preview-official",
    "prompt": "Синяя бутылка с помпой медленно вращается в белой студии, коммерческое product video",
    "duration": 6,
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "image_urls": ["https://example.com/reference.jpg"]
  }'
```

Пример продления видео (`duration` — длина продления в секундах, при отсутствии около 10; результат — исходное видео с продолжением):

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-omni-flash-preview-official",
    "prompt": "Continue the same scene and camera motion",
    "duration": 5,
    "video_list": [{"video_url": "https://example.com/input.mp4"}],
    "metadata": {"task": "extend"}
  }'
```

```json 200 theme={null}
{
  "id": "video_01JZEXAMPLE",
  "object": "generation.task",
  "model": "gemini-omni-flash-preview-official",
  "status": "queued",
  "created_at": 1779247407
}
```

## Query Task

Эндпоинт генерации возвращает ID задачи. Используйте общий эндпоинт статуса видео, чтобы получить статус и результат:

```bash theme={null}
curl --request GET \
  --url https://toapis.com/v1/videos/generations/{task_id} \
  --header "Authorization: Bearer YOUR_API_KEY"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.