> ## 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-image-to-video.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/ImageToVideoRequest'
      responses:
        '200':
          $ref: '#/components/responses/HappyHorseSuccessResponse'
          description: Успешный ответ
      security:
        - CustomApiKey: []
components:
  schemas:
    ImageToVideoRequest:
      type: object
      properties:
        model:
          type: string
          description: >-
            Название модели. Поддерживает happyhorse-1.0-i2v и
            happyhorse-1.1-i2v.
          default: happyhorse-1.0-i2v
          example: happyhorse-1.0-i2v
          enum:
            - happyhorse-1.0-i2v
            - happyhorse-1.1-i2v
        input:
          type: object
          description: Базовая входная информация, такая как промпт и т. д.
          properties:
            prompt:
              type: string
              description: >-
                Текстовый промпт, используемый для описания ожидаемого
                видеоконтента для генерации. Поддерживает ввод на любом языке,
                максимальная длина 5000 некитайских символов или 2500 китайских
                символов. Превышающее содержимое будет автоматически обрезано.
            media:
              type: array
              description: >-
                Список входных медиа. Используется для указания изображения для
                генерации видео. Должно быть ровно 1 изображение первого кадра.
              items:
                type: object
                properties:
                  type:
                    type: string
                    description: 'Тип медиа. Фиксированное значение: first_frame.'
                    enum:
                      - first_frame
                    example: first_frame
                  url:
                    type: string
                    description: >-
                      URL медиа. URL первого кадра. Поддерживает протокол HTTP
                      или HTTPS. Ограничения для изображений: формат: JPEG, JPG,
                      PNG, WEBP; разрешение: ширина и высота не менее 300
                      пикселей; соотношение сторон: 1:2,5–2,5:1; размер файла:
                      не более 10 МБ.
                required:
                  - type
                  - url
          required:
            - media
        parameters:
          type: object
          description: >-
            Параметры обработки видео, такие как настройка разрешения видео,
            продолжительности и т. д.
          properties:
            resolution:
              type: string
              description: >-
                Укажите уровень разрешения для генерируемого видео, используемый
                для управления чёткостью видео (общее количество пикселей).
                Модель автоматически масштабирует до близкого общего количества
                пикселей на основе выбранного уровня разрешения. Соотношение
                сторон выходного видео примерно соответствует первому кадру
                входа.
              default: 1080P
              enum:
                - 720P
                - 1080P
              example: 720P
            duration:
              type: integer
              description: >-
                Укажите продолжительность генерируемого видео в секундах.
                Диапазон значений: целое число от 3 до 15. По умолчанию: 5.
              default: 5
              minimum: 3
              maximum: 15
              example: 5
            watermark:
              type: boolean
              description: >-
                Добавлять ли водяной знак на генерируемое видео. Водяной знак
                расположен в правом нижнем углу видео, текст фиксирован как
                "Happy Horse". true: по умолчанию, добавить водяной знак; false:
                без водяного знака.
              default: true
              example: false
            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.

````