> ## 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: генерация и редактирование видео

> Генерация, редактирование и продление видео 3-10 секунд официальной моделью Gemini Omni 1.1 Flash Preview в четырех разрешениях

* Укажите в `model` значение `gemini-omni-1.1-flash-preview-official`
* Поддерживаются генерация по тексту, по изображению, по референсам, редактирование и продление видео
* До 10 референсных изображений и до 3 входных видео; изображения и видео можно передавать вместе в одном запросе
* Длительность 3-10 секунд; разрешения 360p / 720p / 1080p / 4K
* Асинхронный API задач; после отправки результат запрашивается по ID задачи

> [!NOTE]
>
> Пользователи в материковом Китае могут заменить домен в примерах на `https://toapis.cn`.

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

## Authorizations

**Authorization** `string` *required*

Аутентификация Bearer-токеном:

```
Authorization: Bearer YOUR_API_KEY
```

## Body

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

Имя модели. Используйте `gemini-omni-1.1-flash-preview-official`.

**prompt** `string` *required*

Промпт для генерации, редактирования или продления видео.

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

Длительность видео в секундах, целое `3`-`10`. Для задачи `extend` это длина продления; при отсутствии — около 10 секунд.

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

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

* `16:9` горизонтальное
* `9:16` вертикальное

Не передается для задач `edit` и `extend`.

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

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

* `360p`
* `720p`
* `1080p`
* `4K`

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

Необязательный массив URL референсных изображений, до `10` штук. Без него выполняется генерация по тексту. Можно совмещать с `video_list`, например чтобы приложить референсные изображения при продлении видео.

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

Необязательные входные видео, до `3` штук. Каждый элемент должен содержать `video_url`, например `{ "video_url": "https://example.com/input.mp4" }`. Поддерживаются HTTPS URL, data URI и URL видео, загруженных на платформу; каждое скачиваемое входное видео ограничено 50 МБ, MP4/MOV. Можно совмещать с `image_urls` для смешанного ввода «видео + референсные изображения». Обязательно для задач `edit` и `extend`.

**metadata** `object`

Необязательные параметры генерации Interactions. Поддерживаются `temperature` (`0.0`–`2.0`), `topP` / `top_p` (`0.0`–`1.0`), `candidateCount` / `candidate_count`, `previous_interaction_id`, а также `task` (`text_to_video`, `image_to_video`, `reference_to_video`, `edit` или `extend`). Если `task` не указан, платформа не подставляет значение по умолчанию — режим определяет upstream-модель по промпту и медиа. Для `edit` и `extend` (или при наличии входного видео без явной задачи) платформа не передает `aspect_ratio`. `extend` продолжает исходное видео из `video_list` и несовместим с `previous_interaction_id`.

Параметры, специфичные для Veo (`generateAudio`, `negativePrompt`, `seed`), не поддерживаются.

## 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-1.1-flash-preview-official",
    "prompt": "A red paper boat floating on a calm lake at sunrise",
    "duration": 3,
    "aspect_ratio": "16:9",
    "resolution": "360p"
  }'
```

Пример редактирования видео:

```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-1.1-flash-preview-official",
    "prompt": "Change the sky to a warm sunset",
    "duration": 6,
    "resolution": "1080p",
    "video_list": [{"video_url": "https://example.com/uploaded-video.mp4"}],
    "metadata": {"task": "edit"}
  }'
```

Пример продления видео (`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-1.1-flash-preview-official",
    "prompt": "Continue the scene: the subject keeps moving naturally",
    "duration": 5,
    "video_list": [{"video_url": "https://example.com/uploaded-video.mp4"}],
    "metadata": {"task": "extend"}
  }'
```

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

## Запрос задачи

Эндпоинт генерации возвращает 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.