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

# Создать видео

> Интерфейс генерации видео в совместимом формате OpenAI Sora. Поддерживает режимы генерации видео по тексту и по референсу изображения/видео.

- `POST /v1/videos`: Создание задачи генерации видео
- `GET /v1/videos/{video_id}`: Запрос статуса задачи
- `GET /v1/videos/{video_id}/content`: получить двоичное содержимое видео

В настоящее время недоступно внешним пользователям:
- `GET /v1/videos`
- `POST /v1/videos/{video_id}/remix`

Стандартные заголовки аутентификации:
- `Content-Type: application/json`

1. Создайте задачу через `POST /v1/videos` и получите `id`
2. Выполняйте опрос `GET /v1/videos/{id}`, пока не получите `completed` или `failed`
3. После завершения в первую очередь используйте `video_url` из ответа
4. Если требуется унифицированная загрузка, вызовите `GET /v1/videos/{id}/content`

Основные параметры:
- `model: string`: обязательно, внешнее имя модели
- `prompt: string`: рекомендуется, описание для генерации видео
- `seconds: number|string`: необязательно, целевая длительность
- `duration: number|string`: необязательно, псевдоним длительности
- `size: string`: необязательно, размер выходного видео
- `mode: string`: необязательно, распространённые значения: `t2v` `i2v` `i2v_first_last` `reference_material`

Часто используемые совместимые параметры:
- `aspect_ratio`
- `ratio`
- `quality`
- `resolution`
- `fps`
- `image`
- `image_url`
- `image_urls`
- `images`
- `reference_images`
- `input_reference`
- `end_image_url`
- `last_image_url`
- `video_urls`
- `audio_urls`
- `function_mode`
- `content`
- `callback_url`
- `external_task_id`

Распространённые расширенные параметры Kling:
- `model_name`
- `negative_prompt`
- `cfg_scale`
- `sound`
- `camera_control`
- `image_list`
- `video_id`
- `task_id`
- `watermark_info`

### 4.1 Серия Veo

Примечание: `stable`, `official` и т. п. обозначают разные группы, а не внешний суффикс `model`; при вызове сохраняйте `model` как базовое имя модели, а то, через какую группу пойдёт запрос, определяется группой аккаунта или токена.

#### Основная модель Veo 3.x

- `veo3`
- `veo3-fast`
- `veo3-fast-frames`
- `veo3-frames`
- `veo3-pro`
- `veo3-pro-frames`
- `veo3.1`
- `veo3.1-fast`
- `veo3.1-pro`
- `veo3.1-components`
- `veo3.1-4k`
- `veo3.1-pro-4k`

Рекомендации:
- Для генерации видео только по тексту в первую очередь используйте основные модели `veo3*` / `veo3.1*`
- Для сценариев генерации видео по изображению или по референсу рекомендуется явно передавать `mode + image_url/reference_images`

### 4.2 Серия Sora

Базовые модели:
- `sora-2`
- `sora-2-pro`

Рекомендации:
- `sora-2*` подходит для общего использования
- Если нужно использовать группы `stable` / `official` и т. п., сохраняйте `model` как базовое имя модели и не добавляйте суффикс к имени модели.

Пример запроса:

```json
{
  "size": "1280x720",
  "images": [
    "https://example.png"
  ],
  "model": "sora-2",
  "prompt": "this is an example",
  "duration": 12,
  "fps": "24",
  "seed": "20231024",
  "mode": "i2v"
}
```

### 4.3 Серия HappyHorse

Публичная модель:
- `happyhorse-1.0`

Рекомендации:
- `happyhorse-1.0` различаются с помощью `mode`: `t2v`, `i2v`, `r2v`, `video_edit`.
- В совместимом формате Sora для изображений-референсов рекомендуется передавать медиаэлементы массивом `content`.
- Для текстовых элементов используйте `type=text`, для медиаэлементов — `type=image_url`; также можно использовать `role` и `name` для обозначения назначения материала.

Пример запроса:

```json
{
  "size": "720x1280",
  "model": "happyhorse-1.0",
  "mode": "r2v",
  "prompt": "this is an example",
  "duration": 15,
  "content": [
    {
      "type": "text",
      "text": "this is an example"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.png"
      },
      "role": "reference_image",
      "name": "image1"
    }
  ],
  "parameters": {
    "resolution": "720P",
    "ratio": "9:16",
    "duration": 15,
    "seed": 1
  }
}
```

### 4.4 Серия Seedance

Публичная модель:
- `doubao-seedance-1-0-lite-t2v-250428`
- `doubao-seedance-1-0-lite-i2v-250428`
- `doubao-seedance-1-0-pro-250528`
- `doubao-seedance-1-0-pro-fast-251015`
- `doubao-seedance-1-5-pro-251215`
- `doubao-seedance-2-0-260128`
- `doubao-seedance-2-0-fast-260128`

Рекомендации:
- Для генерации видео по тексту в приоритете `*-t2v-*` или `pro / fast`
- Для генерации видео по изображению в приоритете `*-i2v-*`
- Для сценариев со сложными референсными материалами предпочтительно использовать `content`

Пример запроса:

```json
{
  "size": "1280x720",
  "model": "doubao-seedance-2-0-fast-260128",
  "prompt": "this is an example",
  "duration": 15,
  "fps": "24",
  "seed": "20231024",
  "mode": "reference_material",
  "content": [
    {
      "type": "text",
      "text": "this is an example"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.png"
      },
      "role": "reference_image",
      "name": "image1"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://example.mp3"
      },
      "role": "reference_audio",
      "name": "audio1"
    }
  ]
}
```

### 4.5 Видеосерия Grok

Публичная модель:
- `grok-imagine-1.0-video`
- `grok-imagine-video-1.5-preview`
- `grok-video-3`

Часто используемые параметры:
- `prompt`
- `ratio` / `aspect_ratio`
- `resolution` / `size`
- `seconds` / `duration`
- `image` / `image_url` / `input_reference`
- `reference_images`

Пример:

```json
{
  "model": "grok-imagine-1.0-video",
  "prompt": "雨夜霓虹街道上的电影感推镜，光影丰富，运动自然",
  "reference_images": [
    "https://example.com/ref-1.jpg"
  ],
  "seconds": 10,
  "aspect_ratio": "16:9",
  "resolution": "720P"
}
```

### 4.6 Основная видеомодель Kling

Основная публичная модель:
- `kling-video`

Обязательно:
- `model`
- `model_name`

Поддерживаемые `model_name`:
- `kling-v1`
- `kling-v1-5`
- `kling-v1-6`
- `kling-v2-master`
- `kling-v2-1`
- `kling-v2-1-master`
- `kling-v2-5-turbo`
- `kling-v2-6`
- `kling-v3`

Распространённые `mode`:
- `t2v`
- `i2v`
- `multi_i2v`
- `extend`

Минимальные входные параметры:
- Генерация видео по тексту: `model + model_name + prompt + mode=t2v`
- Генерация видео по изображению: `model + model_name + prompt + mode=i2v + image`
- Референс по нескольким изображениям: `model + model_name + prompt + mode=multi_i2v + image_list`
- Продление видео: `model + model_name + mode=extend + video_id`

Пример:

```json
{
  "model": "kling-video",
  "model_name": "kling-v2-6",
  "mode": "t2v",
  "prompt": "海边日落镜头，电影感，风吹长发",
  "duration": 5,
  "aspect_ratio": "16:9"
}
```

### 4.7 Серия видео MiniMax / Hailuo

Публичная модель:
- `minimax-h3`
- `hailuo-2.3`

Рекомендации:
- `minimax-h3` поддерживает генерацию видео по тексту, а также использование референсных изображений и аудио; рекомендуется смешивать текст и материалы через `content`; также можно использовать совместимые поля, такие как `image_urls` и `audio_urls`.
- `hailuo-2.3` требует изображение первого кадра; рекомендуется передавать элемент `image_url` из `role=first_frame` в `content`, либо использовать `image_urls` для передачи изображения первого кадра.
- `minimax-h3` обычно используют `duration=5~15` и `resolution=1440p`; `hailuo-2.3` обычно используют `duration=6` или `10` и `resolution=768p`.

Пример `minimax-h3`:

```json
{
  "model": "minimax-h3",
  "prompt": "A cinematic product video with smooth camera motion",
  "content": [
    {
      "type": "text",
      "text": "Use the product image as reference and match the rhythm of the audio."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.jpg"
      },
      "role": "reference_image",
      "name": "product"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://example.com/music.mp3"
      },
      "role": "reference_audio",
      "name": "music"
    }
  ],
  "duration": 8,
  "resolution": "1440p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
```

Пример `hailuo-2.3`:

```json
{
  "model": "hailuo-2.3",
  "prompt": "The camera slowly pushes in, natural motion and cinematic lighting.",
  "content": [
    {
      "type": "text",
      "text": "The camera slowly pushes in, natural motion and cinematic lighting."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first-frame.jpg"
      },
      "role": "first_frame",
      "name": "first"
    }
  ],
  "duration": 10,
  "resolution": "768p",
  "aspect_ratio": "16:9"
}
```

- `mode=t2v`
- Минимальное количество входных параметров: `model + prompt`

- `mode=i2v`
- Минимальное количество входных параметров: `model + prompt + image_url`

- `mode=i2v_first_last`
- Минимальное количество входных параметров: `model + prompt + image_url + end_image_url`

- `mode=reference_images`
- Минимальное количество входных параметров: `model + prompt + reference_images`

- `mode=reference_material`
- Минимальное количество входных параметров: `model + prompt + (image_urls/video_urls/audio_urls 至少一种)`

### Инструкция по вызову Gemini Omni

- `gemini-omni` — публичное имя видеомодели в new-api, можно напрямую вызывать через `POST /v1/videos`.
- `mode=t2v`: генерация видео по тексту, минимальный входной параметр — `model + prompt`.
- `mode=r2v`: генерация по референсному изображению/материалу, изображение можно указать в `image`, `image_url`, `images`, `image_urls`, `reference_images`, `input_reference` или `content`.
- `mode=edit`: редактирование видео, видео можно указать в `video`, `video_url`, `videos` или `content`, также можно одновременно передать референсное изображение.
- Для поля длительности можно использовать `seconds` или `duration` — будет автоматически сопоставлено с вариантами 4 / 6 / 8 / 10 секунд.



## OpenAPI

````yaml api-reference/ru/openapi.json POST /v1/videos
openapi: 3.0.0
info:
  title: Справочная документация API для "出海营"
  version: 1.0.0
  description: Public AI Gateway API Reference
servers:
  - url: https://api.aiid.edu.kg
security:
  - BearerAuth: []
tags:
  - name: Формат OpenAI (Chat)
  - name: Формат OpenAI (Responses)
  - name: Формат Gemini для генерации изображений
  - name: Генерация изображенийOpenAI в формате DALL-E
  - name: Получить список моделей
  - name: Генерация видеоHappyHorse и Wan
  - name: ФорматKling генерации видео
  - name: Видео-генерация Omni и формат Veo
  - name: Генерация видео Seedance
  - name: Совместимый формат для Sora генерации видео
  - name: Генерация видео Vidu
  - name: Формат задачи генерации музыки
paths:
  /v1/videos:
    post:
      tags:
        - Совместимый формат для Sora генерации видео
      summary: Создать видео
      description: >-
        Интерфейс генерации видео в совместимом формате OpenAI Sora.
        Поддерживает режимы генерации видео по тексту и по референсу
        изображения/видео.


        - `POST /v1/videos`: Создание задачи генерации видео

        - `GET /v1/videos/{video_id}`: Запрос статуса задачи

        - `GET /v1/videos/{video_id}/content`: получить двоичное содержимое
        видео


        В настоящее время недоступно внешним пользователям:

        - `GET /v1/videos`

        - `POST /v1/videos/{video_id}/remix`


        Стандартные заголовки аутентификации:

        - `Content-Type: application/json`


        1. Создайте задачу через `POST /v1/videos` и получите `id`

        2. Выполняйте опрос `GET /v1/videos/{id}`, пока не получите `completed`
        или `failed`

        3. После завершения в первую очередь используйте `video_url` из ответа

        4. Если требуется унифицированная загрузка, вызовите `GET
        /v1/videos/{id}/content`


        Основные параметры:

        - `model: string`: обязательно, внешнее имя модели

        - `prompt: string`: рекомендуется, описание для генерации видео

        - `seconds: number|string`: необязательно, целевая длительность

        - `duration: number|string`: необязательно, псевдоним длительности

        - `size: string`: необязательно, размер выходного видео

        - `mode: string`: необязательно, распространённые значения: `t2v` `i2v`
        `i2v_first_last` `reference_material`


        Часто используемые совместимые параметры:

        - `aspect_ratio`

        - `ratio`

        - `quality`

        - `resolution`

        - `fps`

        - `image`

        - `image_url`

        - `image_urls`

        - `images`

        - `reference_images`

        - `input_reference`

        - `end_image_url`

        - `last_image_url`

        - `video_urls`

        - `audio_urls`

        - `function_mode`

        - `content`

        - `callback_url`

        - `external_task_id`


        Распространённые расширенные параметры Kling:

        - `model_name`

        - `negative_prompt`

        - `cfg_scale`

        - `sound`

        - `camera_control`

        - `image_list`

        - `video_id`

        - `task_id`

        - `watermark_info`


        ### 4.1 Серия Veo


        Примечание: `stable`, `official` и т. п. обозначают разные группы, а не
        внешний суффикс `model`; при вызове сохраняйте `model` как базовое имя
        модели, а то, через какую группу пойдёт запрос, определяется группой
        аккаунта или токена.


        #### Основная модель Veo 3.x


        - `veo3`

        - `veo3-fast`

        - `veo3-fast-frames`

        - `veo3-frames`

        - `veo3-pro`

        - `veo3-pro-frames`

        - `veo3.1`

        - `veo3.1-fast`

        - `veo3.1-pro`

        - `veo3.1-components`

        - `veo3.1-4k`

        - `veo3.1-pro-4k`


        Рекомендации:

        - Для генерации видео только по тексту в первую очередь используйте
        основные модели `veo3*` / `veo3.1*`

        - Для сценариев генерации видео по изображению или по референсу
        рекомендуется явно передавать `mode + image_url/reference_images`


        ### 4.2 Серия Sora


        Базовые модели:

        - `sora-2`

        - `sora-2-pro`


        Рекомендации:

        - `sora-2*` подходит для общего использования

        - Если нужно использовать группы `stable` / `official` и т. п.,
        сохраняйте `model` как базовое имя модели и не добавляйте суффикс к
        имени модели.


        Пример запроса:


        ```json

        {
          "size": "1280x720",
          "images": [
            "https://example.png"
          ],
          "model": "sora-2",
          "prompt": "this is an example",
          "duration": 12,
          "fps": "24",
          "seed": "20231024",
          "mode": "i2v"
        }

        ```


        ### 4.3 Серия HappyHorse


        Публичная модель:

        - `happyhorse-1.0`


        Рекомендации:

        - `happyhorse-1.0` различаются с помощью `mode`: `t2v`, `i2v`, `r2v`,
        `video_edit`.

        - В совместимом формате Sora для изображений-референсов рекомендуется
        передавать медиаэлементы массивом `content`.

        - Для текстовых элементов используйте `type=text`, для медиаэлементов —
        `type=image_url`; также можно использовать `role` и `name` для
        обозначения назначения материала.


        Пример запроса:


        ```json

        {
          "size": "720x1280",
          "model": "happyhorse-1.0",
          "mode": "r2v",
          "prompt": "this is an example",
          "duration": 15,
          "content": [
            {
              "type": "text",
              "text": "this is an example"
            },
            {
              "type": "image_url",
              "image_url": {
                "url": "https://example.png"
              },
              "role": "reference_image",
              "name": "image1"
            }
          ],
          "parameters": {
            "resolution": "720P",
            "ratio": "9:16",
            "duration": 15,
            "seed": 1
          }
        }

        ```


        ### 4.4 Серия Seedance


        Публичная модель:

        - `doubao-seedance-1-0-lite-t2v-250428`

        - `doubao-seedance-1-0-lite-i2v-250428`

        - `doubao-seedance-1-0-pro-250528`

        - `doubao-seedance-1-0-pro-fast-251015`

        - `doubao-seedance-1-5-pro-251215`

        - `doubao-seedance-2-0-260128`

        - `doubao-seedance-2-0-fast-260128`


        Рекомендации:

        - Для генерации видео по тексту в приоритете `*-t2v-*` или `pro / fast`

        - Для генерации видео по изображению в приоритете `*-i2v-*`

        - Для сценариев со сложными референсными материалами предпочтительно
        использовать `content`


        Пример запроса:


        ```json

        {
          "size": "1280x720",
          "model": "doubao-seedance-2-0-fast-260128",
          "prompt": "this is an example",
          "duration": 15,
          "fps": "24",
          "seed": "20231024",
          "mode": "reference_material",
          "content": [
            {
              "type": "text",
              "text": "this is an example"
            },
            {
              "type": "image_url",
              "image_url": {
                "url": "https://example.png"
              },
              "role": "reference_image",
              "name": "image1"
            },
            {
              "type": "audio_url",
              "audio_url": {
                "url": "https://example.mp3"
              },
              "role": "reference_audio",
              "name": "audio1"
            }
          ]
        }

        ```


        ### 4.5 Видеосерия Grok


        Публичная модель:

        - `grok-imagine-1.0-video`

        - `grok-imagine-video-1.5-preview`

        - `grok-video-3`


        Часто используемые параметры:

        - `prompt`

        - `ratio` / `aspect_ratio`

        - `resolution` / `size`

        - `seconds` / `duration`

        - `image` / `image_url` / `input_reference`

        - `reference_images`


        Пример:


        ```json

        {
          "model": "grok-imagine-1.0-video",
          "prompt": "雨夜霓虹街道上的电影感推镜，光影丰富，运动自然",
          "reference_images": [
            "https://example.com/ref-1.jpg"
          ],
          "seconds": 10,
          "aspect_ratio": "16:9",
          "resolution": "720P"
        }

        ```


        ### 4.6 Основная видеомодель Kling


        Основная публичная модель:

        - `kling-video`


        Обязательно:

        - `model`

        - `model_name`


        Поддерживаемые `model_name`:

        - `kling-v1`

        - `kling-v1-5`

        - `kling-v1-6`

        - `kling-v2-master`

        - `kling-v2-1`

        - `kling-v2-1-master`

        - `kling-v2-5-turbo`

        - `kling-v2-6`

        - `kling-v3`


        Распространённые `mode`:

        - `t2v`

        - `i2v`

        - `multi_i2v`

        - `extend`


        Минимальные входные параметры:

        - Генерация видео по тексту: `model + model_name + prompt + mode=t2v`

        - Генерация видео по изображению: `model + model_name + prompt +
        mode=i2v + image`

        - Референс по нескольким изображениям: `model + model_name + prompt +
        mode=multi_i2v + image_list`

        - Продление видео: `model + model_name + mode=extend + video_id`


        Пример:


        ```json

        {
          "model": "kling-video",
          "model_name": "kling-v2-6",
          "mode": "t2v",
          "prompt": "海边日落镜头，电影感，风吹长发",
          "duration": 5,
          "aspect_ratio": "16:9"
        }

        ```


        ### 4.7 Серия видео MiniMax / Hailuo


        Публичная модель:

        - `minimax-h3`

        - `hailuo-2.3`


        Рекомендации:

        - `minimax-h3` поддерживает генерацию видео по тексту, а также
        использование референсных изображений и аудио; рекомендуется смешивать
        текст и материалы через `content`; также можно использовать совместимые
        поля, такие как `image_urls` и `audio_urls`.

        - `hailuo-2.3` требует изображение первого кадра; рекомендуется
        передавать элемент `image_url` из `role=first_frame` в `content`, либо
        использовать `image_urls` для передачи изображения первого кадра.

        - `minimax-h3` обычно используют `duration=5~15` и `resolution=1440p`;
        `hailuo-2.3` обычно используют `duration=6` или `10` и
        `resolution=768p`.


        Пример `minimax-h3`:


        ```json

        {
          "model": "minimax-h3",
          "prompt": "A cinematic product video with smooth camera motion",
          "content": [
            {
              "type": "text",
              "text": "Use the product image as reference and match the rhythm of the audio."
            },
            {
              "type": "image_url",
              "image_url": {
                "url": "https://example.com/product.jpg"
              },
              "role": "reference_image",
              "name": "product"
            },
            {
              "type": "audio_url",
              "audio_url": {
                "url": "https://example.com/music.mp3"
              },
              "role": "reference_audio",
              "name": "music"
            }
          ],
          "duration": 8,
          "resolution": "1440p",
          "aspect_ratio": "16:9",
          "generate_audio": true
        }

        ```


        Пример `hailuo-2.3`:


        ```json

        {
          "model": "hailuo-2.3",
          "prompt": "The camera slowly pushes in, natural motion and cinematic lighting.",
          "content": [
            {
              "type": "text",
              "text": "The camera slowly pushes in, natural motion and cinematic lighting."
            },
            {
              "type": "image_url",
              "image_url": {
                "url": "https://example.com/first-frame.jpg"
              },
              "role": "first_frame",
              "name": "first"
            }
          ],
          "duration": 10,
          "resolution": "768p",
          "aspect_ratio": "16:9"
        }

        ```


        - `mode=t2v`

        - Минимальное количество входных параметров: `model + prompt`


        - `mode=i2v`

        - Минимальное количество входных параметров: `model + prompt +
        image_url`


        - `mode=i2v_first_last`

        - Минимальное количество входных параметров: `model + prompt + image_url
        + end_image_url`


        - `mode=reference_images`

        - Минимальное количество входных параметров: `model + prompt +
        reference_images`


        - `mode=reference_material`

        - Минимальное количество входных параметров: `model + prompt +
        (image_urls/video_urls/audio_urls 至少一种)`


        ### Инструкция по вызову Gemini Omni


        - `gemini-omni` — публичное имя видеомодели в new-api, можно напрямую
        вызывать через `POST /v1/videos`.

        - `mode=t2v`: генерация видео по тексту, минимальный входной параметр —
        `model + prompt`.

        - `mode=r2v`: генерация по референсному изображению/материалу,
        изображение можно указать в `image`, `image_url`, `images`,
        `image_urls`, `reference_images`, `input_reference` или `content`.

        - `mode=edit`: редактирование видео, видео можно указать в `video`,
        `video_url`, `videos` или `content`, также можно одновременно передать
        референсное изображение.

        - Для поля длительности можно использовать `seconds` или `duration` —
        будет автоматически сопоставлено с вариантами 4 / 6 / 8 / 10 секунд.
      operationId: createVideo
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  description: >-
                    Обязательно, внешнее имя модели. `gemini-omni` Можно
                    вызывать через `/v1/videos`.
                  enum:
                    - sora-2
                    - sora-2-pro
                    - gemini-omni
                    - happyhorse-1.0
                    - happyhorse-1.0-i2v
                    - happyhorse-1.0-t2v
                    - happyhorse-1.0-r2v
                    - happyhorse-1.0-video-edit
                    - doubao-seedance-1-0-lite-i2v-250428
                    - doubao-seedance-1-0-lite-t2v-250428
                    - doubao-seedance-1-0-pro-250528
                    - doubao-seedance-1-0-pro-fast-251015
                    - doubao-seedance-1-5-pro-251215
                    - doubao-seedance-2-0-260128
                    - doubao-seedance-2-0-fast-260128
                    - veo3
                    - veo3-fast
                    - veo3-fast-frames
                    - veo3-frames
                    - veo3-pro
                    - veo3-pro-frames
                    - veo3.1
                    - veo3.1-4k
                    - veo3.1-components
                    - veo3.1-fast
                    - veo3.1-pro
                    - veo3.1-pro-4k
                    - kling-video
                    - grok-imagine-1.0-video
                    - grok-imagine-video-1.5-preview
                    - grok-video-3
                    - minimax-h3
                    - hailuo-2.3
                    - viduq3-turbo
                  example: sora-2
                prompt:
                  type: string
                  description: >-
                    Единая точка входа для промптов. Обязательно для большинства
                    моделей.
                image:
                  type: string
                  format: binary
                  description: >-
                    Вход для одного изображения; в некоторых режимах
                    совместимости сопоставляется с `images`.
                duration:
                  type: integer
                  description: >-
                    Унифицированный параметр для длительности; некоторые модели
                    также принимают seconds.
                width:
                  type: integer
                  example: 512
                  description: Video width
                height:
                  type: integer
                  example: 512
                  description: Video height
                fps:
                  type: integer
                  example: 30
                  description: Video frame rate
                seed:
                  type: integer
                  example: 20231234
                  description: Random seed
                'n':
                  type: integer
                  example: 1
                  description: Number of videos to generate
                response_format:
                  type: string
                  example: url
                  description: Response format
                user:
                  type: string
                  example: user-1234
                  description: User identifier
                metadata:
                  type: object
                  additionalProperties: true
                  description: >-
                    Контейнер динамически расширяемых полей. Здесь
                    десериализуется большое количество специфичных для модели
                    полей.
                mode:
                  type: string
                  description: >-
                    Необязательно, режим генерации видео. `gemini-omni`
                    Поддерживает `t2v`、`r2v`、`edit`。
                images:
                  type: array
                  description: >-
                    Единая точка входа для нескольких изображений. Используется
                    в Vidu, Seedance, Veo и т. д.
                  items:
                    type: string
                content:
                  type: array
                  items:
                    type: object
                    additionalProperties: true
                size:
                  type: string
                  description: >-
                    Унифицированная точка входа для размера; будет
                    сопоставляться с resolution/aspect_ratio и т. д.
                seconds:
                  type: string
                  description: >-
                    Sora Совместимый входной параметр; во время выполнения будет
                    выполняться откат к duration.
                input_reference:
                  type: string
                  description: >-
                    Совместимый входной параметр для эталонного изображения
                    Sora/Veo, может быть multipart-файлом или совместимым
                    объектом.
                parameters:
                  type: object
                  additionalProperties: true
              required:
                - model
                - prompt
            examples:
              openai_i2v_json:
                summary: OpenAI Sora i2v (application/json)
                value:
                  size: 1280x720
                  images:
                    - https://example.png
                  model: sora-2
                  prompt: this is an example
                  duration: 12
                  fps: '24'
                  seed: '20231024'
                  mode: i2v
              openai_i2v_input_reference:
                summary: OpenAI i2v (input_reference)
                value:
                  model: sora-2
                  prompt: A cinematic drone shot over snowy mountains at sunrise
                  input_reference:
                    image_url: https://example.com/input.jpg
                  seconds: '8'
                  size: 1280x720
                  response_format: url
              openai_alias_compat:
                summary: Alias兼容 (image_url/duration/aspect_ratio)
                value:
                  model: sora-2
                  prompt: A cinematic drone shot over snowy mountains at sunrise
                  image_url: https://example.com/input.jpg
                  duration: '8'
                  aspect_ratio: '16:9'
                  response_format: url
              gemini_omni_sora_t2v:
                summary: Gemini Omni Sora t2v
                value:
                  model: gemini-omni
                  mode: t2v
                  prompt: A cinematic product video with smooth camera motion
                  duration: 8
                  size: 1280x720
              gemini_omni_sora_r2v:
                summary: Gemini Omni Sora r2v
                value:
                  model: gemini-omni
                  mode: r2v
                  content:
                    - type: text
                      text: Keep the product consistent and create a short ad video
                    - type: image_url
                      image_url:
                        url: https://example.com/product.jpg
                  duration: 8
                  size: 1280x720
              gemini_omni_sora_edit:
                summary: Gemini Omni Sora edit
                value:
                  model: gemini-omni
                  mode: edit
                  content:
                    - type: text
                      text: Change the outfit color while keeping the motion natural
                    - type: video_url
                      video_url:
                        url: https://example.com/input.mp4
                    - type: image_url
                      image_url:
                        url: https://example.com/style.jpg
                  duration: 8
                  size: 1280x720
              happyhorse_sora_t2v:
                summary: HappyHorse Sora t2v
                value:
                  model: happyhorse-1.0
                  mode: t2v
                  content:
                    - type: text
                      text: >-
                        A cinematic white horse running through a neon city
                        street
                  duration: 5
                  resolution: 720P
                  ratio: '16:9'
              happyhorse_sora_i2v:
                summary: HappyHorse Sora i2v
                value:
                  model: happyhorse-1.0
                  mode: i2v
                  content:
                    - type: text
                      text: The camera slowly pushes in, natural motion
                    - type: image_url
                      image_url: https://example.com/first-frame.jpg
                  duration: 5
                  resolution: 720P
              happyhorse_sora_r2v:
                summary: HappyHorse Sora r2v
                value:
                  size: 720x1280
                  model: happyhorse-1.0
                  mode: r2v
                  prompt: this is an example
                  duration: 15
                  content:
                    - type: text
                      text: this is an example
                    - type: image_url
                      image_url:
                        url: https://example.png
                      role: reference_image
                      name: image1
                  parameters:
                    resolution: 720P
                    ratio: '9:16'
                    duration: 15
                    seed: 1
              happyhorse_sora_video_edit:
                summary: HappyHorse Sora video_edit
                value:
                  model: happyhorse-1.0
                  mode: video_edit
                  content:
                    - type: text
                      text: >-
                        Change the jacket to a striped sweater and keep the
                        motion natural
                    - type: video_url
                      video_url: https://example.com/input.mp4
                    - type: image_url
                      image_url: https://example.com/reference.jpg
                  resolution: 720P
              seedance_i2v_first:
                summary: Seedance i2v_first
                value:
                  model: doubao-seedance-1-0-lite-i2v-250428
                  mode: i2v_first
                  prompt: A panda skateboarding in a city street, cinematic
                  image_urls:
                    - https://example.com/first.jpg
                  seconds: '5'
                  size: 1280x720
              seedance_i2v_first_last:
                summary: Seedance i2v_first_last
                value:
                  model: doubao-seedance-1-0-lite-i2v-250428
                  mode: i2v_first_last
                  prompt: A camera moves from first frame to last frame naturally
                  image_urls:
                    - https://example.com/first.jpg
                  end_image_url: https://example.com/last.jpg
                  seconds: '5'
                  size: 1280x720
              seedance_reference_images:
                summary: Seedance reference_images
                value:
                  model: doubao-seedance-1-0-lite-i2v-250428
                  mode: reference_images
                  prompt: Stylized short video keeping character consistency
                  reference_images:
                    - https://example.com/ref-1.jpg
                    - https://example.com/ref-2.jpg
                  seconds: '5'
                  size: 1280x720
              seedance_reference_material:
                summary: Seedance Универсальный режим参考 материала (reference_material)
                value:
                  model: doubao-seedance-1-0-lite-i2v-250428
                  mode: reference_material
                  prompt: >-
                    Blend image and short reference video into a coherent
                    cinematic clip
                  reference_images:
                    - https://example.com/ref-1.jpg
                    - https://example.com/ref-2.jpg
                  video_urls:
                    - https://example.com/ref-video.mp4
                  audio_urls:
                    - https://example.com/ref-audio.mp3
                  seconds: '5'
                  size: 1280x720
              seedance_volc_content:
                summary: Seedance режим content Volcano Ark
                value:
                  size: 1280x720
                  model: doubao-seedance-2-0-fast-260128
                  prompt: this is an example
                  duration: 15
                  fps: '24'
                  seed: '20231024'
                  mode: reference_material
                  content:
                    - type: text
                      text: this is an example
                    - type: image_url
                      image_url:
                        url: https://example.png
                      role: reference_image
                      name: image1
                    - type: audio_url
                      audio_url:
                        url: https://example.mp3
                      role: reference_audio
                      name: audio1
              veo_first_last_frame:
                summary: Veo Режим начального и конечного кадра
                value:
                  model: veo3.1-fast
                  prompt: >-
                    A smooth transition from first frame to last frame,
                    cinematic motion
                  image_urls:
                    - https://example.com/first-frame.jpg
                  end_image_url: https://example.com/last-frame.jpg
                  seconds: '8'
                  size: 1280x720
              veo_reference_images_1to3:
                summary: Veo режим с 1–3 референсными изображениями
                value:
                  model: veo3.1-fast
                  prompt: >-
                    Use reference style and character consistency for a short ad
                    clip
                  reference_images:
                    - https://example.com/ref-1.jpg
                  seconds: '8'
                  size: 1280x720
              kling_text2video:
                summary: Kling Генерация видео по тексту
                value:
                  model: kling-video
                  prompt: A cat playing piano in the garden
                  duration: 5
                  size: 1280x720
                  metadata:
                    negative_prompt: blurry, low quality
                    mode: std
              kling_image2video:
                summary: Kling Генерация видео по изображению
                value:
                  model: kling-video
                  prompt: A cat playing piano in the garden
                  image: https://example.com/input.jpg
                  duration: 5
                  size: 1280x720
                  metadata:
                    negative_prompt: blurry, low quality
                    mode: std
              grok_reference_video:
                summary: Grok Видеорежим
                value:
                  model: grok-imagine-1.0-video
                  prompt: A dramatic cinematic shot with fast motion and rich lighting
                  reference_images:
                    - https://example.com/ref-1.jpg
                  seconds: 10
                  aspect_ratio: '16:9'
                  resolution: 720P
              minimax_h3_sora_reference:
                summary: MiniMax H3, видео с несколькими типами материалов
                value:
                  model: minimax-h3
                  prompt: A cinematic product video with smooth camera motion
                  content:
                    - type: text
                      text: >-
                        Use the product image as reference and match the rhythm
                        of the audio.
                    - type: image_url
                      image_url:
                        url: https://example.com/product.jpg
                      role: reference_image
                      name: product
                    - type: audio_url
                      audio_url:
                        url: https://example.com/music.mp3
                      role: reference_audio
                      name: music
                  duration: 8
                  resolution: 1440p
                  aspect_ratio: '16:9'
                  generate_audio: true
              hailuo_2_3_sora_first_frame:
                summary: Hailuo 2.3 Генерация видео по первому кадру изображения
                value:
                  model: hailuo-2.3
                  prompt: >-
                    The camera slowly pushes in, natural motion and cinematic
                    lighting.
                  content:
                    - type: text
                      text: >-
                        The camera slowly pushes in, natural motion and
                        cinematic lighting.
                    - type: image_url
                      image_url:
                        url: https://example.com/first-frame.jpg
                      role: first_frame
                      name: first
                  duration: 10
                  resolution: 768p
                  aspect_ratio: '16:9'
              vidu_sora_t2v:
                summary: Vidu Sora t2v
                value:
                  model: viduq3-turbo
                  mode: t2v
                  content:
                    - type: text
                      text: A stylish product ad clip with cinematic lighting
                  duration: 5
                  resolution: 720p
                  aspect_ratio: '16:9'
              vidu_sora_i2v:
                summary: Vidu Sora i2v
                value:
                  model: viduq3-turbo
                  mode: i2v
                  content:
                    - type: text
                      text: A stylish ad clip from a product still image
                    - type: image_url
                      image_url: https://example.com/product.jpg
                  duration: 5
                  resolution: 720p
              vidu_sora_first_last:
                summary: Vidu Sora i2v_first_last
                value:
                  model: viduq3-turbo
                  mode: i2v_first_last
                  content:
                    - type: text
                      text: A smooth shot from start frame to end frame
                    - type: image_url
                      image_url: https://example.com/start.jpg
                    - type: image_url
                      image_url: https://example.com/end.jpg
                  duration: 5
                  resolution: 720p
              vidu_sora_reference:
                summary: Vidu Sora reference_images
                value:
                  model: viduq3-turbo
                  mode: reference_images
                  content:
                    - type: text
                      text: Maintain product style and character consistency
                    - type: image_url
                      image_url: https://example.com/ref-1.jpg
                    - type: image_url
                      image_url: https://example.com/ref-2.jpg
                    - type: image_url
                      image_url: https://example.com/ref-3.jpg
                  duration: 5
                  resolution: 720p
                  aspect_ratio: '16:9'
              hailuo_text2video:
                summary: Hailuo 2.3 Генерация видео по первому кадру изображения
                value:
                  model: hailuo-2.3
                  prompt: A cinematic travel shot over the coastline
                  image_urls:
                    - https://example.com/first-frame.jpg
                  duration: 6
                  resolution: 768p
                  aspect_ratio: '16:9'
      responses:
        '200':
          description: Задача на создание видео успешно создана
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  task_id:
                    type: string
                    description: >-
                      Совместимо со старым интерфейсом; подлежит выводу из
                      эксплуатации
                  object:
                    type: string
                  model:
                    type: string
                  status:
                    type: string
                    description: >-
                      Should use VideoStatus constants: VideoStatusQueued,
                      VideoStatusInProgress, VideoStatusCompleted,
                      VideoStatusFailed
                    enum:
                      - queued
                      - in_progress
                      - completed
                      - failed
                      - video_url
                      - url
                      - completed_at
                  progress:
                    type: integer
                  created_at:
                    type: integer
                  completed_at:
                    type: integer
                  expires_at:
                    type: integer
                  seconds:
                    type: string
                  size:
                    type: string
                  remixed_from_video_id:
                    type: string
                  error:
                    type: object
                  metadata:
                    type: object
                    additionalProperties: true
                  output:
                    type: object
                  request_id:
                    type: string
                required:
                  - created_at
                  - id
                  - model
                  - object
                  - progress
                  - status
              example:
                id: video_abc123
                object: video
                model: sora-2
                status: queued
                progress: 0
                created_at: 1764347090922
                seconds: '8'
          headers: {}
        '400':
          description: Ошибка параметров запроса
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers: {}
      deprecated: false
      security:
        - BearerAuth: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: Сообщение об ошибке
            type:
              type: string
              description: Тип ошибки
            param:
              type: string
              description: Связанные параметры
              nullable: true
            code:
              type: string
              description: Код ошибки
              nullable: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Используйте проверку подлинности Bearer Token.
        Формат: `Authorization: Bearer sk-xxxxxx`

````