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

# Редактирование видео

> Редактирование видео — редактирование видео на основе видео и эталонных изображений

Это интерфейс **видео API HappyHorse** для редактирования видео, редактирование видео на основе видео и эталонных изображений.


## OpenAPI

````yaml openapi/ru/happyhorse-video-edit.json POST /happyhorse/api/v1/services/aigc/video-generation/video-synthesis
openapi: 3.1.0
info:
  title: API редактирования видео HappyHorse
  version: 1.0.0
  description: >-
    HappyHorse API для редактирования видео — редактирование видео на основе
    видео и эталонных изображений
servers:
  - url: https://api.ttapi.io
security: []
paths:
  /happyhorse/api/v1/services/aigc/video-generation/video-synthesis:
    post:
      description: >-
        Редактирование видео — редактирование видео на основе видео и эталонных
        изображений
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoEditRequest'
      responses:
        '200':
          $ref: '#/components/responses/HappyHorseSuccessResponse'
          description: Успешный ответ
      security:
        - CustomApiKey: []
components:
  schemas:
    VideoEditRequest:
      type: object
      properties:
        model:
          type: string
          description: 'Название модели. Фиксированное значение: happyhorse-1.0-video-edit.'
          default: happyhorse-1.0-video-edit
          example: happyhorse-1.0-video-edit
        input:
          type: object
          description: >-
            Базовая входная информация, включая видео для редактирования,
            эталонные изображения и промпт.
          properties:
            prompt:
              type: string
              description: >-
                Текстовый промпт, используемый для описания намерения
                редактирования видео, такого как передача стиля, частичная
                замена и т. д. Поддерживает ввод на любом языке, максимальная
                длина 5000 некитайских символов или 2500 китайских символов.
                Превышающее содержимое будет автоматически обрезано.
            media:
              type: array
              description: >-
                Список медиа, используемый для указания видео для редактирования
                и эталонных изображений. Массив должен содержать 1 элемент типа
                video; опционально может содержать от 0 до 5 элементов типа
                reference_image.
              items:
                oneOf:
                  - type: object
                    description: Видео для редактирования
                    properties:
                      type:
                        type: string
                        description: >-
                          Тип медиа. Фиксированное значение: video (видео для
                          редактирования).
                        enum:
                          - video
                        example: video
                      url:
                        type: string
                        description: >-
                          URL видео для редактирования, должен быть
                          общедоступным URL. Поддерживает протокол HTTP и HTTPS.
                          Ограничения для видео: формат: MP4, MOV (рекомендуется
                          кодирование H.264); продолжительность: 3–60 секунд;
                          разрешение: длинная сторона не более 2160 пикселей,
                          короткая сторона не менее 320 пикселей; соотношение
                          сторон: 1:2,5–2,5:1; размер файла: не более 100 МБ;
                          частота кадров: более 8fps. Продолжительность
                          выходного видео: 3–15 секунд (когда входное видео не
                          превышает 15 секунд, продолжительность вывода
                          соответствует входу; когда входное видео превышает 15
                          секунд, система автоматически обрезает первые 15
                          секунд как допустимый сегмент, поэтому максимальный
                          вывод составляет 15 секунд).
                    required:
                      - type
                      - url
                  - type: object
                    description: Эталонное изображение
                    properties:
                      type:
                        type: string
                        description: 'Тип медиа. Фиксированное значение: reference_image.'
                        enum:
                          - reference_image
                        example: reference_image
                      url:
                        type: string
                        description: >-
                          URL эталонного изображения, должен быть общедоступным
                          URL. Поддерживает протокол HTTP или HTTPS. Ограничения
                          для изображений: формат: JPEG, JPG, PNG, WEBP;
                          разрешение: ширина и высота не менее 300 пикселей;
                          соотношение сторон: 1:2,5–2,5:1; размер файла: не
                          более 10 МБ.
                    required:
                      - type
                      - url
          required:
            - prompt
            - media
        parameters:
          type: object
          description: >-
            Параметры редактирования видео, такие как настройка разрешения видео
            и т. д.
          properties:
            resolution:
              type: string
              description: Уровень разрешения генерируемого видео.
              default: 1080P
              enum:
                - 720P
                - 1080P
              example: 720P
            watermark:
              type: boolean
              description: >-
                Добавлять ли водяной знак на генерируемое видео. Водяной знак
                расположен в правом нижнем углу видео, текст фиксирован как
                "Happy Horse". true: по умолчанию, добавить водяной знак; false:
                без водяного знака.
              default: true
              example: false
            audio_setting:
              type: string
              description: >-
                Управление звуком. auto: по умолчанию, управляется моделью;
                origin: сохранить оригинальный звук входного видео.
              default: auto
              enum:
                - auto
                - origin
              example: auto
            seed:
              type: integer
              description: >-
                Случайное зерно, диапазон значений: [0, 2147483647]. Если не
                указано, система автоматически сгенерирует случайное зерно. Для
                повышения воспроизводимости результатов генерации рекомендуется
                зафиксировать значение зерна. Обратите внимание, что из-за
                вероятностной природы генерации модели, даже при одинаковом
                зерне нельзя гарантировать идентичные результаты каждый раз.
              minimum: 0
              maximum: 2147483647
              example: 12345
      required:
        - model
        - input
  responses:
    HappyHorseSuccessResponse:
      description: Запрос успешен
      content:
        application/json:
          schema:
            type: object
            properties:
              output:
                type: object
                description: Информация о выводе задачи
                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
            example:
              output:
                task_status: PENDING
                task_id: 0385dc79-5ff8-4d82-bcb6-xxxxxx
              request_id: 4909100c-7b5a-9f92-bfe5-xxxxxx
            required:
              - output
              - request_id
  securitySchemes:
    CustomApiKey:
      type: apiKey
      in: header
      name: TT-API-KEY
      description: >-
        Пожалуйста, перейдите на <a href='https://dashboard.ttapi.io'
        target='_blank'>консоль TTAPI</a>, чтобы получить ключ API.

````