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

> ## Agent Instructions
> Send API requests to https://api.ttapi.io with the TT-API-KEY header. Midjourney account hosting uses https://hold.ttapi.io. Claude Code uses https://cc.ttapi.io.
> Most generation endpoints are asynchronous. The submit response returns a job id. Poll that product's fetch endpoint, or pass a webhook on the submit request. A fetch call does not start a new generation.
> 1 USD = 100 quota. Check the pricing page for that product before estimating cost.
> This file lists the English docs. Follow every /_llms/ link recursively for the API reference, Chinese, and Russian. Open a page's .md URL for the endpoint schema.

# Омни-референс

> Омни-референс генерация видео. Генерация нового видео путём слияния мультимодального контента на основе референсных изображений и видео.Все 4 модели. Отправьте асинхронную задачу ивернуть id，используйте эндпоинт для получения результата。

Эндпоинт омни-референс **Seedance API генерации видео**. Генерация нового видео путём слияния мультимодального контента на основе референсных изображений и видео. Все 4 модели. Отправьте асинхронную задачу и верните id.

**Использование**: Включите `text`, `image_url` (role=reference\_image), `video_url` (role=reference\_video), опционально `audio_url` (role=reference\_audio) в `content`, установите `omni_reference_task_type: "reference"`.


## OpenAPI

````yaml openapi/ru/seedance-omni-reference.json POST /sd/api/v3/contents/generations/tasks
openapi: 3.1.0
info:
  title: Seedance API генерации видео (Омни-референс)
  version: 1.0.0
  description: Генерация видео через омни-референс из референсных изображений и видео.
servers:
  - url: https://api.ttapi.io
security: []
paths:
  /sd/api/v3/contents/generations/tasks:
    post:
      description: >-
        Омни-референс генерация видео. Генерация нового видео путём слияния
        мультимодального контента на основе референсных изображений и видео.Все
        4 модели. Отправьте асинхронную задачу ивернуть id，используйте эндпоинт
        для получения результата。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateRequest'
            example:
              model: doubao-seedance-2-5-260628
              content:
                - type: text
                  text: Яркий и красочный рекламный стиль
                - type: image_url
                  image_url:
                    url: https://example.com/ref.png
                  role: reference_image
                - type: video_url
                  video_url:
                    url: https://example.com/ref.mp4
                  role: reference_video
              omni_reference_task_type: reference
              ratio: '16:9'
              duration: 15
              generate_audio: true
              output_format: mov
              watermark: true
      responses:
        '200':
          description: Задача успешно отправлена
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: ID задачи
                example:
                  id: cgt-20261021120000-xxxxx
                required:
                  - id
      security:
        - CustomApiKey: []
components:
  schemas:
    CreateRequest:
      type: object
      properties:
        model:
          type: string
          enum:
            - doubao-seedance-2-5-260628
            - doubao-seedance-2-0-260128
            - doubao-seedance-2-0-fast-260128
            - doubao-seedance-2-0-mini-260615
          description: ID модели
        content:
          type: array
          items:
            $ref: '#/components/schemas/ContentItem'
          description: >-
            Список входного контента. Поддерживает комбинацию text + image_url
            (reference_image) + video_url (reference_video) + audio_url
            (reference_audio)
        omni_reference_task_type:
          type: string
          enum:
            - reference
          description: >-
            Тип задачи, фиксированное значение reference (референс-в-видео).
            Варианты: auto=автоопределение, reference=референс-в-видео,
            edit=редактирование, extend=продление
        resolution:
          type: string
          enum:
            - 480p
            - 720p
            - 1080p
          default: 720p
          description: 'Разрешение видео. Seedance 2.5: 480p, 720p, 1080p. По умолчанию 720p'
        ratio:
          type: string
          enum:
            - adaptive
            - '16:9'
            - '4:3'
            - '1:1'
            - '3:4'
            - '9:16'
            - '21:9'
          default: adaptive
          description: >-
            Соотношение сторон видео. По умолчанию adaptive (авто), или укажите
            конкретное
        duration:
          type: integer
          default: -1
          description: >-
            Длительность видео (сек). Диапазон [4, 30] или -1 (умный выбор).
            duration и frames выберите одно из двух, frames приоритет выше
        generate_audio:
          type: boolean
          default: true
          description: >-
            Генерировать синхронизированный звук. true=вокал/эффекты/музыка,
            false=без звука。только Seedance 2.5/2.0 поддерживается
        output_format:
          type: string
          enum:
            - mp4
            - mov
          default: mp4
          description: >-
            Формат вывода. mp4=стандартный формат, mov=высокая точность
            цвета(H.264+yuv444p+PCM, для профессиональногоого постпродакшена).
            только Seedance 2.5 поддерживается
        watermark:
          type: boolean
          default: false
          description: >-
            Добавить водяной знак。true=отобразить в правом нижнем углу「AI
            создать」
        return_last_frame:
          type: boolean
          default: false
          description: >-
            Вернуть изображение последнего кадра。true=вернуть jpeg формат
            последнего кадра，можнодлянепрерывное видеосоздать
        draft:
          type: boolean
          default: false
          description: >-
            Включить режим черновика. true=создать превью 480p. Только Seedance
            2.5
        callback_url:
          type: string
          description: >-
            URL обратного вызова。Статус задачиизмененииотправка POST
            запрос，содержимое совпадает с запросом API ответом API
        execution_expires_after:
          type: integer
          default: 172800
          description: >-
            Тайм-аут задачи (сек). Диапазон [3600, 259200]（1~72  ч），по умолчанию
            172800（48  ч）
        priority:
          type: integer
          default: 0
          description: >-
            Приоритет выполнения. Диапазон [0, 9]，больше значение = выше
            приоритет，по умолчанию 0（FIFO）。только Seedance 2.5/2.0
            поддерживается
        safety_identifier:
          type: string
          description: >-
            Уникальный идентификатор пользователя, макс. 64 символа.
            Рекомендуется передавать хешированную строку
        tools:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                  - web_search
                description: >-
                  Тип инструмента. web_search=поиск в интернете, модель
                  самостоятельно решает, искать ли контент в интернете
          description: Конфигурация инструментов。только Seedance 2.5/2.0 поддерживается
        service_tier:
          type: string
          enum:
            - default
          default: default
          description: >-
            Уровень обслуживания. default=онлайн инференс, flex=оффлайн
            инференс(цена 50%, Seedance 2.5/2.0 пока не поддерживается)
        seed:
          type: integer
          default: -1
          description: Случайное зерно. Диапазон [-1, 2147483647], -1=случайное
        camera_fixed:
          type: boolean
          default: false
          description: >-
            Фиксированная камера. true=фиксированная камера (не поддерживается
            для сцен с референсным изображением)
        frames:
          type: integer
          description: >-
            Количество кадров видео. диапазон [29, 289], должно соответствовать
            25+4n формат. и duration выберите одно из двух, frames приоритет
            выше
      required:
        - model
        - content
        - omni_reference_task_type
    ContentItem:
      type: object
      description: >-
        Элемент входного контента，поддерживается
        text、image_url、video_url、audio_url、draft_task тип
      oneOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - text
            text:
              type: string
              description: >-
                Текстовый промпт, макс. 500 китайских иероглифов или 1000
                английских слов
          required:
            - type
            - text
        - type: object
          properties:
            type:
              type: string
              enum:
                - image_url
            image_url:
              type: object
              properties:
                url:
                  type: string
                  description: >-
                    URL изображения / Base64 / Asset ID (asset://<ASSET_ID>).
                    Форматы: jpeg/png/webp/bmp/tiff/gif/heic/heif，Соотношение
                    сторон [0.4, 2.5]，размер < 30MB
            role:
              type: string
              enum:
                - reference_image
              description: >-
                Назначение изображения, обязательно reference_image для
                омни-референса
          required:
            - type
            - image_url
        - type: object
          properties:
            type:
              type: string
              enum:
                - video_url
            video_url:
              type: object
              properties:
                url:
                  type: string
                  description: >-
                    URL видео / Asset ID. Формат: mp4/mov, длительность [2,
                    30]с, размер ≤ 200МБ
            role:
              type: string
              enum:
                - reference_video
              description: Фиксированное значение reference_video
          required:
            - type
            - video_url
            - role
        - type: object
          properties:
            type:
              type: string
              enum:
                - audio_url
            audio_url:
              type: object
              properties:
                url:
                  type: string
                  description: >-
                    URL аудио / Base64 / Asset ID. Формат: wav/mp3, длительность
                    [2, 30]с, размер ≤ 15МБ
            role:
              type: string
              enum:
                - reference_audio
              description: Фиксированное значение reference_audio
          required:
            - type
            - audio_url
            - role
        - type: object
          properties:
            type:
              type: string
              enum:
                - draft_task
            draft_task:
              type: object
              properties:
                id:
                  type: string
                  description: ID задачи черновика, действителен 7 дней
          required:
            - type
            - draft_task
  securitySchemes:
    CustomApiKey:
      type: apiKey
      in: header
      name: TT-API-KEY
      description: >-
        Получите API-ключ в <a href='https://dashboard.ttapi.io'
        target='_blank'>панели TTAPI</a>.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.