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

# Создать видео（Seedance）

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

Используется для создания задач генерации видео и получения статуса и результатов по ID задачи.

Основные поля для создания задачи:
- `model`: Обязательно, название модели.
- `prompt`: Обязательно, основное описание для генерации видео.
- `content`: необязательный массив content Volcano Ark, для смешанного размещения текста, изображений, видео и аудио.
- `function_mode`: Опционально, часто используется в расширенных режимах, таких как универсальный референс.

Совместимые входные параметры:

Следующие поля в основном предназначены для совместимости со старыми клиентами и устаревшими протоколами. Для новых интеграций по возможности используйте стандартный формат из «Примера запроса» на этой странице: для текста и reference materials используйте массив `content`, а для настроек генерации — верхнеуровневые поля `duration`, `ratio`, `resolution`, `fps` и т. д.

- `mode`：`t2v / i2v / i2v_first_last / reference_images / reference_material`
- `image_url / image_urls / input_reference`
- `end_image_url / last_image_url`
- `video_urls / audio_urls`
- `seconds / duration`
- `aspect_ratio / ratio / size`
- `quality / resolution`
- `fps`
- `generate_audio / watermark`

Детали вызова:
- При использовании `mode=reference_material` или `function_mode=omni_reference` рекомендуется передавать текст и референсные материалы через `content`.
- `content`: текстовый элемент задаётся в формате `{ "type": "text", "text": "测试文字" }`.
- `content`: элементы изображений, видео и аудио оформляются соответственно с помощью объектов `image_url`, `video_url` и `audio_url`, например `{ "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }`.
- `role` может обозначать назначение материала, `name` можно ссылаться по имени в подсказке.
- `ratio`, `duration`, `resolution` и `fps` влияют на итоговую конфигурацию генерации.

Вызов Gemini Omni:
- `gemini-omni` также можно вызывать через этот интерфейс задачи Seedance.
- `mode=t2v` используется для генерации видео по тексту, `mode=r2v` — для генерации по референсным изображениям/материалам, `mode=edit` — для редактирования видео.
- Текст можно размещать в элементе `text` в `prompt` или `content`; изображения можно размещать в `image_url / image_urls / reference_images / input_reference / content`; видео — в `video_urls / content`.
- Для поля длительности можно использовать `duration` или `seconds` — будет автоматически сопоставлено с вариантами 4 / 6 / 8 / 10 секунд.

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

Ключевые поля в результатах запроса:
- `items[].status`
- `items[].content.video_url` или `items[].video_url`
- `items[].error`
- `items[].progress`

Error fields: `error.code`, `error.message`.

```json
{
  "error": {
    "code": "invalid_request_error",
    "message": "requires at least one image in `images`"
  }
}
```



## OpenAPI

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


        Используется для создания задач генерации видео и получения статуса и
        результатов по ID задачи.


        Основные поля для создания задачи:

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

        - `prompt`: Обязательно, основное описание для генерации видео.

        - `content`: необязательный массив content Volcano Ark, для смешанного
        размещения текста, изображений, видео и аудио.

        - `function_mode`: Опционально, часто используется в расширенных
        режимах, таких как универсальный референс.


        Совместимые входные параметры:


        Следующие поля в основном предназначены для совместимости со старыми
        клиентами и устаревшими протоколами. Для новых интеграций по возможности
        используйте стандартный формат из «Примера запроса» на этой странице:
        для текста и reference materials используйте массив `content`, а для
        настроек генерации — верхнеуровневые поля `duration`, `ratio`,
        `resolution`, `fps` и т. д.


        - `mode`：`t2v / i2v / i2v_first_last / reference_images /
        reference_material`

        - `image_url / image_urls / input_reference`

        - `end_image_url / last_image_url`

        - `video_urls / audio_urls`

        - `seconds / duration`

        - `aspect_ratio / ratio / size`

        - `quality / resolution`

        - `fps`

        - `generate_audio / watermark`


        Детали вызова:

        - При использовании `mode=reference_material` или
        `function_mode=omni_reference` рекомендуется передавать текст и
        референсные материалы через `content`.

        - `content`: текстовый элемент задаётся в формате `{ "type": "text",
        "text": "测试文字" }`.

        - `content`: элементы изображений, видео и аудио оформляются
        соответственно с помощью объектов `image_url`, `video_url` и
        `audio_url`, например `{ "type": "image_url", "image_url": { "url":
        "https://example.com/ref.png" }, "role": "reference_image", "name": "1"
        }`.

        - `role` может обозначать назначение материала, `name` можно ссылаться
        по имени в подсказке.

        - `ratio`, `duration`, `resolution` и `fps` влияют на итоговую
        конфигурацию генерации.


        Вызов Gemini Omni:

        - `gemini-omni` также можно вызывать через этот интерфейс задачи
        Seedance.

        - `mode=t2v` используется для генерации видео по тексту, `mode=r2v` —
        для генерации по референсным изображениям/материалам, `mode=edit` — для
        редактирования видео.

        - Текст можно размещать в элементе `text` в `prompt` или `content`;
        изображения можно размещать в `image_url / image_urls / reference_images
        / input_reference / content`; видео — в `video_urls / content`.

        - Для поля длительности можно использовать `duration` или `seconds` —
        будет автоматически сопоставлено с вариантами 4 / 6 / 8 / 10 секунд.


        Вызов MiniMax / Hailuo:

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

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

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


        Ключевые поля в результатах запроса:

        - `items[].status`

        - `items[].content.video_url` или `items[].video_url`

        - `items[].error`

        - `items[].progress`


        Error fields: `error.code`, `error.message`.


        ```json

        {
          "error": {
            "code": "invalid_request_error",
            "message": "requires at least one image in `images`"
          }
        }

        ```
      operationId: create__seedance__task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - prompt
              properties:
                model:
                  type: string
                  example: doubao-seedance-2-0-260128
                  enum:
                    - 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
                    - minimax-h3
                    - hailuo-2.3
                    - gemini-omni
                  description: >-
                    Обязательно. Имя модели. Можно передать внешнюю модель
                    Seedance, `gemini-omni`, `minimax-h3` или `hailuo-2.3`.
                prompt:
                  type: string
                  example: 参考素材生成一段剧情短视频
                  description: >-
                    Обязательно. Основное описание для генерации видео, не может
                    быть пустым.
                content:
                  type: array
                  description: >-
                    Необязательно. Массив content в Volcano Ark, в котором
                    текстовые и медиа-элементы чередуются в заданном порядке.
                    Текстовые элементы используют `{ "type": "text", "text":
                    "..." }`; элементы изображения, видео и аудио —
                    соответственно объекты `image_url`, `video_url` и
                    `audio_url`, в которые помещается `url`; можно использовать
                    вместе с `role` (например, `reference_image`,
                    `reference_video`, `reference_audio`) и `name` для ссылок в
                    тексте.
                  items:
                    type: object
                    required:
                      - type
                    properties:
                      type:
                        type: string
                        enum:
                          - text
                          - image_url
                          - video_url
                          - audio_url
                        description: Тип элемента содержимого.
                      text:
                        type: string
                        description: >-
                          Текстовое содержимое, используется только при
                          type=text.
                      image_url:
                        oneOf:
                          - type: string
                          - type: object
                            properties:
                              url:
                                type: string
                        description: >-
                          URL изображения, рекомендуется запись в виде объекта:
                          `{"url":"https://..."}`.
                      video_url:
                        oneOf:
                          - type: string
                          - type: object
                            properties:
                              url:
                                type: string
                        description: >-
                          URL видео, рекомендуется объектная запись:
                          `{"url":"https://..."}`.
                      audio_url:
                        oneOf:
                          - type: string
                          - type: object
                            properties:
                              url:
                                type: string
                        description: >-
                          URL аудио, рекомендуемый формат записи объекта:
                          `{"url":"https://..."}`.
                      role:
                        type: string
                        description: >-
                          Идентификатор назначения материала, распространённые
                          значения: reference_image, reference_video,
                          reference_audio.
                      name:
                        type: string
                        description: >-
                          Название материала, может использоваться в текстовом
                          prompt'е или для различения нескольких материалов.
                function_mode:
                  type: string
                  description: >-
                    Необязательно. Режим расширенных функций, например
                    `omni_reference`, для универсального справочника.
                mode:
                  type: string
                  description: >-
                    Необязательно. Поля режима совместимости, например `t2v`,
                    `i2v`, `i2v_first_last`, `reference_images`,
                    `reference_material`; `gemini-omni` поддерживает `t2v`,
                    `r2v`, `edit`.
                image_url:
                  type: string
                  description: Необязательно. URL-адрес одного эталонного изображения.
                image_urls:
                  type: array
                  items:
                    type: string
                  description: >-
                    Необязательно. Список URL-адресов нескольких референсных
                    изображений.
                input_reference:
                  type: string
                  description: >-
                    Необязательно. Поле ввода для обеспечения обратной
                    совместимости.
                end_image_url:
                  type: string
                  description: >-
                    Необязательно. URL-адрес референсного изображения для
                    последнего кадра.
                last_image_url:
                  type: string
                  description: >-
                    Необязательно. Псевдоним URL-адреса референсного изображения
                    последнего кадра.
                video_urls:
                  type: array
                  items:
                    type: string
                  description: Необязательно. Список URL-адресов справочных видеороликов.
                audio_urls:
                  type: array
                  items:
                    type: string
                  description: Необязательно. Список URL-адресов эталонного аудио.
                seconds:
                  oneOf:
                    - type: number
                    - type: string
                  description: >-
                    Необязательно. Длительность видео в секундах; совместимо с
                    `duration`.
                duration:
                  oneOf:
                    - type: number
                    - type: string
                  description: >-
                    Необязательно. Длительность видео в секундах; совместимо с
                    `seconds`.
                aspect_ratio:
                  type: string
                  description: Необязательно. Соотношение сторон, например `16:9`.
                ratio:
                  type: string
                  description: >-
                    Необязательно. Псевдоним соотношения сторон, например
                    `16:9`.
                size:
                  type: string
                  description: Необязательно. Поле совместимости разрешения или размера.
                quality:
                  type: string
                  description: Необязательно. Конфигурация качества генерации.
                resolution:
                  type: string
                  description: Необязательно. Разрешение на выходе.
                fps:
                  type: number
                  description: Необязательно. Частота кадров.
                generate_audio:
                  type: boolean
                  description: Необязательно. Указывает, нужно ли генерировать аудио.
                watermark:
                  type: boolean
                  description: Необязательно. Указывает, нужно ли добавлять водяной знак.
            examples:
              seedance_tasks_reference_material:
                summary: Seedance содержимое задачи
                value:
                  model: doubao-seedance-1-0-lite-i2v-250428
                  mode: reference_material
                  prompt: 测试文字
                  content:
                    - type: text
                      text: 测试文字
                    - type: image_url
                      image_url:
                        url: >-
                          https://imageproxy.zhongzhuan.chat/api/proxy/image/9979f1a754b3571d5e8bdcc397eedf53.png
                      role: reference_image
                      name: '1'
                    - type: video_url
                      video_url:
                        url: >-
                          https://imageproxy.zhongzhuan.chat/api/proxy/video/1979f1a754b3571d5e8bdcc397eedf53.mp4
                      role: reference_video
                      name: '2'
                    - type: audio_url
                      audio_url:
                        url: >-
                          https://imageproxy.zhongzhuan.chat/api/proxy/video/3979f1a754b3571d5e8bdcc397eedf53.mp3
                      role: reference_audio
                      name: '3'
                  duration: 5
                  size: 1280x720
              minimax_h3_tasks_content:
                summary: Задача MiniMax H3 content
                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
                  ratio: '16:9'
                  generate_audio: true
              hailuo_2_3_tasks_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
                  ratio: '16:9'
              gemini_omni_seedance_t2v:
                summary: Gemini Omni t2v
                value:
                  model: gemini-omni
                  mode: t2v
                  prompt: A cinematic product video with smooth camera motion
                  duration: 8
                  size: 1280x720
              gemini_omni_seedance_r2v:
                summary: Gemini Omni 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_seedance_edit:
                summary: Gemini Omni 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
      responses:
        '200':
          description: Задача успешно создана
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                properties:
                  id:
                    type: string
                    example: task_xxx
                    description: ID задачи.
                  status:
                    type: string
                    description: Статус задачи.
                    enum:
                      - queued
                      - running
                      - succeeded
                      - failed
                  created_at:
                    type: string
                    description: Время создания (Unix-время в секундах).
                  items:
                    type: string
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: ID задачи.
                        status:
                          type: string
                          description: >-
                            Статус задачи, обычно: `queued`, `running`,
                            `succeeded`, `failed`.
                        content:
                          type: object
                          properties:
                            video_url:
                              type: string
                              description: URL-адрес результата видео.
                        video_url:
                          type: string
                          description: URL-адрес результата видео.
                        error:
                          type: string
                          description: Сообщение об ошибке в случае сбоя.
                        progress:
                          type: string
                          description: Ход выполнения задачи.
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Используйте проверку подлинности Bearer Token.
        Формат: `Authorization: Bearer sk-xxxxxx`

````