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

# Ссылка в видео

> Создать задачу создания видео по ссылке

Это конечная точка создания видео по ссылке **Wan 3.0 Video Generation API**. Создайте видео, загрузив справочные материалы с типами `reference_image`, `reference_video` или `reference_audio`, в сочетании с запросом.


## OpenAPI

````yaml openapi/ru/wan-reference-to-video.json POST /wan/api/v1/services/aigc/video-generation/video-synthesis
openapi: 3.1.0
info:
  title: Wan 3.0 - Reference to Video DOCS
  version: 1.0.0
  description: >-
    Wan 3.0 API создания видео по ссылке - Загрузите справочные материалы с
    типами `reference_image`, `reference_video` или `reference_audio`, в
    сочетании с запросом.
servers:
  - url: https://api.ttapi.io
security: []
paths:
  /wan/api/v1/services/aigc/video-generation/video-synthesis:
    post:
      description: Создать задачу создания видео по ссылке
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReferenceToVideoRequest'
            examples:
              reference_image_example:
                summary: Пример справочного изображения
                description: >-
                  Генерация видео с использованием справочного изображения,
                  поддерживает комбинации различных типов медиа
                value:
                  model: wan3.0-video
                  input:
                    prompt: Спокойный пейзаж с легким ветром, развевающим траву
                    media_list:
                      - type: reference_image
                        url: https://example.com/reference-image.jpg
                      - type: reference_video
                        url: https://example.com/reference-video.mp4
                      - type: reference_audio
                        url: https://example.com/audio.mp3
                      - type: link
                        url: https://example.com/article
                      - type: file
                        url: https://example.com/document.pdf
                  parameters:
                    resolution: 720P
                    duration: 5
              reference_video_example:
                summary: Пример справочного видео
                description: Генерация нового видео с использованием справочного видео
                value:
                  model: wan3.0-video
                  input:
                    prompt: Сохранить тот же стиль, но изменить сцену
                    media_list:
                      - type: reference_video
                        url: https://example.com/reference-video.mp4
                  parameters:
                    resolution: 1080P
                    duration: 10
              reference_audio_example:
                summary: Пример справочного аудио
                description: Генерация видео с использованием справочного аудио
                value:
                  model: wan3.0-video
                  input:
                    prompt: Видео, соответствующее ритму аудио
                    media_list:
                      - type: reference_audio
                        url: https://example.com/audio.mp3
                  parameters:
                    resolution: 720P
                    duration: 5
              link_example:
                summary: Пример веб-ссылки
                description: Генерация видео с использованием веб-ссылки
                value:
                  model: wan3.0-video
                  input:
                    prompt: Генерация видео на основе содержимого веб-страницы
                    media_list:
                      - type: link
                        url: https://example.com/article
                  parameters:
                    resolution: 720P
                    duration: 5
              file_example:
                summary: Пример файла
                description: Генерация видео с использованием загруженного файла
                value:
                  model: wan3.0-video
                  input:
                    prompt: Генерация видео на основе содержимого файла
                    media_list:
                      - type: file
                        url: https://example.com/document.pdf
                  parameters:
                    resolution: 720P
                    duration: 5
      responses:
        '200':
          description: Успешный ответ
          content:
            application/json:
              schema:
                type: object
                properties:
                  output:
                    type: object
                    properties:
                      task_status:
                        type: string
                        description: Статус задачи
                        enum:
                          - PENDING
                          - RUNNING
                          - SUCCEEDED
                          - FAILED
                          - CANCELED
                          - UNKNOWN
                        example: PENDING
                      task_id:
                        type: string
                        description: >-
                          ID задачи. Действителен для запроса в течение 24
                          часов.
                        example: 0385dc79-5ff8-4d82-bcb6-xxxxxx
                  request_id:
                    type: string
                    description: Уникальный идентификатор запроса.
                    example: 4909100c-7b5a-9f92-bfe5-xxxxxx
      security:
        - CustomApiKey: []
components:
  schemas:
    ReferenceToVideoRequest:
      type: object
      description: Параметры запроса создания видео по ссылке
      properties:
        model:
          type: string
          description: |-
            Название модели. Варианты:
            - `wan3.0-video`: Стандартная версия.
          enum:
            - wan3.0-video
          example: wan3.0-video
        input:
          type: object
          description: >-
            Основная информация о входных данных. Требуется либо prompt, либо
            media.
          properties:
            prompt:
              type: string
              description: >-
                Текстовый запрос, описывающий ожидаемое содержание видео.
                Поддерживает китайский и английский языки, до 20000 символов. В
                режиме reference-to-video можно использовать 'Изображение 1',
                'Видео 1', 'Аудио 1' и т.д. для ссылки на медиа-материалы в
                соответствующем порядке массива media.
            media:
              type: array
              description: >-
                Массив медиа-материалов. В режиме reference-to-video используйте
                type: 'reference_image', 'reference_video', 'reference_audio'
                или 'link' для загрузки справочных материалов. **Важно**: типы
                `reference_xx/file/link` являются взаимоисключающими и не могут
                использоваться вместе в одном запросе.
              items:
                type: object
                properties:
                  type:
                    type: string
                    description: >-
                      Тип медиа-материала. Режим reference-to-video использует
                      следующие типы:

                      - `reference_image`: Справочное изображение. До 10
                      изображений.

                      - `reference_video`: Справочное видео. До 5 сегментов,
                      общая длительность не более 15 секунд.

                      - `reference_audio`: Справочный аудиофайл. До 5 сегментов,
                      общая длительность не более 15 секунд.

                      - `link`: Веб-ссылка. До 1 ссылки, нельзя использовать
                      одновременно с file.

                      - `file`: Файл. Максимум 1, нельзя использовать
                      одновременно с link.
                    enum:
                      - reference_image
                      - reference_video
                      - reference_audio
                      - link
                    example: reference_image
                  url:
                    type: string
                    description: URL медиа-материала или данные в формате Base64.
                required:
                  - type
                  - url
        parameters:
          type: object
          description: Параметры обработки видео.
          properties:
            resolution:
              type: string
              description: >-
                Уровень разрешения генерируемого видео. По умолчанию 1080P.
                Варианты: 1080P, 720P, 480P
              default: 1080P
              enum:
                - 1080P
                - 720P
                - 480P
              example: 1080P
            ratio:
              type: string
              description: >-
                Соотношение сторон генерируемого видео. Варианты: adaptive (по
                умолчанию), 16:9, 4:3, 1:1, 3:4, 9:16
              default: adaptive
              enum:
                - adaptive
                - '16:9'
                - '4:3'
                - '1:1'
                - '3:4'
                - '9:16'
              example: adaptive
            duration:
              type: integer
              description: >-
                Длительность генерируемого видео в секундах. Целое число в
                диапазоне [2, 30] или -1 для режима умной длительности.
              default: 5
              example: 10
            audio:
              type: boolean
              description: >-
                Включает ли выходное видео звук. true: со звуком (по умолчанию),
                false: без звуковой дорожки.
              default: true
              example: true
            seed:
              type: integer
              description: >-
                Случайное seed для воспроизведения результатов генерации.
                Диапазон: [0, 2147483647].
              minimum: 0
              maximum: 2147483647
              example: 12345
            prompt_extend:
              type: boolean
              description: >-
                Включить интеллектуальную перезапись prompt. true: включено (по
                умолчанию), false: выключено.
              default: true
              example: true
            watermark:
              type: boolean
              description: >-
                Добавить водяной знак. false: без водяного знака (по умолчанию),
                true: добавить.
              default: false
              example: false
      required:
        - model
        - input
  securitySchemes:
    CustomApiKey:
      type: apiKey
      in: header
      name: TT-API-KEY
      description: >-
        Пожалуйста, посетите <a href='https://dashboard.ttapi.io'
        target='_blank'>панель управления TTAPI</a> для получения ключа API.

````