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

# Создать видео по эталонному видео(Vidu)

> Эта серия поддерживает формат генерации видео OpenAI (подробности см. по ссылке [совместимые форматы видео生成Sora ](/api-reference/ru/generaciya-video-sovmestimyi-format-sora/sozdat-video)).

Vidu Официальный интерфейс генерации видео; публичный путь соответствует официальному протоколу Vidu.

Текущая публичная модель: `viduq3-turbo`. Поддерживает генерацию видео по тексту, по изображению, по первым и последним кадрам и по референсу. Эта же модель также поддерживает подключение через совместимый формат Sora с `/v1/videos`; часто используемые `mode`: `t2v`、`i2v`、`i2v_first_last`、`reference_images`.

Дополнены общая структура публичного запроса для официального формата генерации видео Vidu, структура запроса статуса задачи и рекомендуемый шаблон проверки; публичный путь сохраняет формат официального endpoint Vidu.

Поддерживаемые модели:
viduq3-turbo

Унифицированные поля запроса:
- `model` (string, обязательно): внешнее имя модели Vidu, текущая публичная версия `viduq3-turbo`.
- `prompt` (string, необязательно): подсказка для генерации видео; обязательна для генерации видео по тексту, для генерации по изображению/первым и последним кадрам/по референсу передается по необходимости.
- `images` (array[string], необязательно): входные изображения. Для генерации видео по изображению — 1 изображение, для первых и последних кадров — 2 изображения, для генерации по референсу — 1~7 изображений.
- `videos` (array[string], необязательно): для генерации по референсу — необязательный вход с видео-объектом, используется в соответствии с возможностями официальной модели Vidu.
- `subjects` (array[object], необязательно): вход в формате библиотеки объектов для генерации по референсу; может включать поля, такие как имя объекта, изображение, видео или тембр.
- `duration` (integer, необязательно): длительность видео в секундах. `viduq3-turbo` Обычно 5 секунд, можно задать в пределах, указанных в официальной документации.
- `resolution` (string, необязательно): выходное разрешение, распространенные значения: `540p`、`720p`、`1080p`.
- `aspect_ratio` (string, необязательно): выходное соотношение сторон, часто используется для генерации видео по тексту/по референсу, например `16:9`、`9:16`、`1:1`.
- `seed` (integer, необязательно): случайное зерно.
- `movement_amplitude` (string, необязательно): амплитуда движения, распространенные значения: `auto`、`small`、`medium`、`large`.
- `audio` (boolean, необязательно): включить ли прямой вывод аудио и видео.
- `off_peak` (boolean, необязательно): использовать ли поэтапную генерацию.
- `watermark` (boolean, необязательно): добавлять ли водяной знак.

Основные различия моделей/режимов:
- `Vidu 文生视频`: поддерживаемая модель viduq3-turbo; генерация видео по тексту в официальном формате.
- `Vidu 图生视频`: поддерживаемая модель viduq3-turbo; генерация видео по одному изображению в официальном формате.
- `Vidu 首尾帧生视频`: поддерживаемая модель viduq3-turbo; генерация видео по двум изображениям первых и последних кадров в официальном формате.
- `Vidu 参考生视频`: поддерживаемая модель viduq3-turbo; генерация видео по нескольким референсным изображениям в официальном формате.



## OpenAPI

````yaml api-reference/ru/openapi.json POST /ent/v2/reference2video
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:
  /ent/v2/reference2video:
    post:
      tags:
        - Генерация видео Vidu
      summary: Создать видео по эталонному видео(Vidu)
      description: >-
        Эта серия поддерживает формат генерации видео OpenAI (подробности см. по
        ссылке [совместимые форматы видео生成Sora
        ](/api-reference/ru/generaciya-video-sovmestimyi-format-sora/sozdat-video)).


        Vidu Официальный интерфейс генерации видео; публичный путь соответствует
        официальному протоколу Vidu.


        Текущая публичная модель: `viduq3-turbo`. Поддерживает генерацию видео
        по тексту, по изображению, по первым и последним кадрам и по референсу.
        Эта же модель также поддерживает подключение через совместимый формат
        Sora с `/v1/videos`; часто используемые `mode`:
        `t2v`、`i2v`、`i2v_first_last`、`reference_images`.


        Дополнены общая структура публичного запроса для официального формата
        генерации видео Vidu, структура запроса статуса задачи и рекомендуемый
        шаблон проверки; публичный путь сохраняет формат официального endpoint
        Vidu.


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

        viduq3-turbo


        Унифицированные поля запроса:

        - `model` (string, обязательно): внешнее имя модели Vidu, текущая
        публичная версия `viduq3-turbo`.

        - `prompt` (string, необязательно): подсказка для генерации видео;
        обязательна для генерации видео по тексту, для генерации по
        изображению/первым и последним кадрам/по референсу передается по
        необходимости.

        - `images` (array[string], необязательно): входные изображения. Для
        генерации видео по изображению — 1 изображение, для первых и последних
        кадров — 2 изображения, для генерации по референсу — 1~7 изображений.

        - `videos` (array[string], необязательно): для генерации по референсу —
        необязательный вход с видео-объектом, используется в соответствии с
        возможностями официальной модели Vidu.

        - `subjects` (array[object], необязательно): вход в формате библиотеки
        объектов для генерации по референсу; может включать поля, такие как имя
        объекта, изображение, видео или тембр.

        - `duration` (integer, необязательно): длительность видео в секундах.
        `viduq3-turbo` Обычно 5 секунд, можно задать в пределах, указанных в
        официальной документации.

        - `resolution` (string, необязательно): выходное разрешение,
        распространенные значения: `540p`、`720p`、`1080p`.

        - `aspect_ratio` (string, необязательно): выходное соотношение сторон,
        часто используется для генерации видео по тексту/по референсу, например
        `16:9`、`9:16`、`1:1`.

        - `seed` (integer, необязательно): случайное зерно.

        - `movement_amplitude` (string, необязательно): амплитуда движения,
        распространенные значения: `auto`、`small`、`medium`、`large`.

        - `audio` (boolean, необязательно): включить ли прямой вывод аудио и
        видео.

        - `off_peak` (boolean, необязательно): использовать ли поэтапную
        генерацию.

        - `watermark` (boolean, необязательно): добавлять ли водяной знак.


        Основные различия моделей/режимов:

        - `Vidu 文生视频`: поддерживаемая модель viduq3-turbo; генерация видео по
        тексту в официальном формате.

        - `Vidu 图生视频`: поддерживаемая модель viduq3-turbo; генерация видео по
        одному изображению в официальном формате.

        - `Vidu 首尾帧生视频`: поддерживаемая модель viduq3-turbo; генерация видео по
        двум изображениям первых и последних кадров в официальном формате.

        - `Vidu 参考生视频`: поддерживаемая модель viduq3-turbo; генерация видео по
        нескольким референсным изображениям в официальном формате.
      operationId: createViduReferenceVideo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - prompt
                - images
              properties:
                model:
                  type: string
                  enum:
                    - viduq3-turbo
                  example: viduq3-turbo
                  description: >-
                    Vidu — внешнее имя модели, в настоящее время публично
                    доступен `viduq3-turbo`.
                prompt:
                  type: string
                  example: A cinematic product ad with smooth camera motion
                  description: >-
                    Промпт для генерации видео; обязателен для генерации видео
                    по тексту, для генерации по изображению/по первым и
                    последним кадрам/по референсу передавайте по необходимости
                    бизнес-сценария.
                images:
                  type: array
                  items:
                    type: string
                    format: uri
                  example:
                    - https://example.com/input.jpg
                  description: >-
                    Входное изображение. Для генерации видео по изображению — 1
                    изображение, для первых и последних кадров — 2 изображения,
                    для генерации видео по референсу — 1–7 изображений.
                videos:
                  type: array
                  items:
                    type: string
                    format: uri
                  description: >-
                    При генерации видео по референсу можно использовать
                    необязательный ввод основного объекта видео, в соответствии
                    с возможностями официальной модели Vidu.
                subjects:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                      images:
                        type: array
                        items:
                          type: string
                          format: uri
                      videos:
                        type: array
                        items:
                          type: string
                          format: uri
                      voice_id:
                        type: string
                      server_id:
                        type: string
                  description: >-
                    Ввод в формате, соответствующем формату библиотеки объектов
                    для генерации видео, может включать поля, такие как название
                    объекта, изображение, видео или тембр голоса.
                auto_subjects:
                  type: boolean
                duration:
                  type: integer
                  example: 5
                  description: >-
                    Длительность видео, в секундах. `viduq3-turbo` Обычно 5
                    секунд, можно задать в пределах, указанных в официальной
                    документации.
                resolution:
                  type: string
                  enum:
                    - 540p
                    - 720p
                    - 1080p
                  example: 720p
                  description: >-
                    Разрешение вывода, распространённые значения
                    `540p`、`720p`、`1080p`.
                aspect_ratio:
                  type: string
                  enum:
                    - '16:9'
                    - '9:16'
                    - '4:3'
                    - '3:4'
                    - '1:1'
                  example: '16:9'
                  description: >-
                    Соотношение сторон вывода, часто используется для генерации
                    видео по тексту/референсу, например `16:9`、`9:16`、`1:1`.
                seed:
                  type: integer
                  description: Случайное зерно.
                movement_amplitude:
                  type: string
                  enum:
                    - auto
                    - small
                    - medium
                    - large
                  example: auto
                  description: >-
                    Амплитуда движения, распространённые значения
                    `auto`、`small`、`medium`、`large`。
                audio:
                  type: boolean
                  description: Включить ли прямой вывод аудио и видео.
                audio_type:
                  type: string
                  enum:
                    - all
                    - speech_only
                    - sound_effect_only
                voice_id:
                  type: string
                is_rec:
                  type: boolean
                bgm:
                  type: boolean
                payload:
                  type: string
                off_peak:
                  type: boolean
                  description: Использовать ли генерацию в непиковое время.
                watermark:
                  type: boolean
                  description: Добавлять ли водяной знак.
                wm_position:
                  type: integer
                  enum:
                    - 1
                    - 2
                    - 3
                    - 4
                wm_url:
                  type: string
                  format: uri
                callback_url:
                  type: string
                  format: uri
            examples:
              vidu_native_t2v:
                summary: Vidu Генерация видео по тексту
                value:
                  model: viduq3-turbo
                  prompt: A cinematic product ad with smooth camera motion
                  duration: 5
                  resolution: 720p
                  aspect_ratio: '16:9'
              vidu_native_i2v:
                summary: Vidu Видео из изображения
                value:
                  model: viduq3-turbo
                  images:
                    - https://example.com/product.jpg
                  prompt: The product rotates slowly under studio light
                  duration: 5
                  resolution: 720p
              vidu_native_start_end:
                summary: Vidu Генерация видео по начальной и конечной кадрам
                value:
                  model: viduq3-turbo
                  images:
                    - https://example.com/start.jpg
                    - https://example.com/end.jpg
                  prompt: A smooth camera move from the first frame to the final frame
                  duration: 5
                  resolution: 720p
              vidu_native_reference:
                summary: Vidu видео, сгенерированное по образцу
                value:
                  model: viduq3-turbo
                  images:
                    - https://example.com/ref-1.jpg
                    - https://example.com/ref-2.jpg
                    - https://example.com/ref-3.jpg
                  prompt: >-
                    Keep the same character and product style in a cinematic
                    shot
                  duration: 5
                  resolution: 720p
                  aspect_ratio: '16:9'
      responses:
        '200':
          description: Задача успешно создана
          content:
            application/json:
              schema:
                type: object
                required:
                  - task_id
                  - state
                properties:
                  task_id:
                    type: string
                    description: >-
                      ID задачи, возвращаемый при создании задачи, используется
                      для ее запроса.
                  state:
                    type: string
                    enum:
                      - created
                      - queueing
                      - processing
                      - success
                      - failed
                    description: >-
                      Статус задачи, распространённые значения
                      `created`、`queueing`、`processing`、`success`、`failed`.
                  model:
                    type: string
                  prompt:
                    type: string
                  images:
                    type: array
                    items:
                      type: string
                  duration:
                    type: integer
                  resolution:
                    type: string
                  created_at:
                    type: string
                  creations:
                    type: string
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          description: >-
                            URL созданного видео после успешного выполнения
                            задачи.
                        cover_url:
                          type: string
                          description: URL обложки после успешного выполнения задачи.
                        watermarked_url:
                          type: string
                          description: URL видео с водяным знаком.
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Используйте проверку подлинности Bearer Token.
        Формат: `Authorization: Bearer sk-xxxxxx`

````