> ## 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 GET /api/v3/contents/generations/tasks/{task_id}
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/{task_id}:
    get:
      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: query__seedance__task
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          description: Task ID
      responses:
        '200':
          description: Успешный запрос
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: ID задачи.
                  model:
                    type: string
                  status:
                    type: string
                    description: Статус задачи.
                    enum:
                      - queued
                      - running
                      - succeeded
                      - failed
                  error:
                    type: object
                    nullable: true
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                  created_at:
                    type: integer
                    description: Время создания (Unix-время в секундах).
                  updated_at:
                    type: integer
                  content:
                    type: object
                    properties:
                      video_url:
                        type: string
                      last_frame_url:
                        type: string
                  usage:
                    type: object
                    properties:
                      completion_tokens:
                        type: integer
                      total_tokens:
                        type: integer
                  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`

````