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

> Просмотр документации видео API HappyHorse, включая интерфейсы преобразования текста в видео, изображения в видео, генерации по ссылке, редактирования видео и запроса задач, подходит для интеграции AI видеоприложений.

# HappyHorse Видео API

Это страница обзора **видео API HappyHorse**. Здесь вы можете быстро узнать о различных возможностях генерации и редактирования видео от HappyHorse и получить доступ к документации конкретных API.

## Что умеет видео API HappyHorse

HappyHorse предоставляет множество возможностей генерации и редактирования видео для различных сценариев:

* **Текст в видео**: Генерация высококачественных видео непосредственно из текстовых промптов
* **Изображение в видео (Первый кадр)**: Генерация видео на основе одного изображения первого кадра
* **Генерация по ссылке**: Генерация видео на основе нескольких эталонных изображений (1-9 изображений), с поддержкой ссылок на персонажей через идентификаторы
* **Редактирование видео**: Редактирование на основе существующих видео и эталонных изображений, с поддержкой передачи стиля, частичной замены и т. д.
* **Запрос задач**: Запрос статуса и результатов асинхронных задач генерации видео

## Общие интерфейсы видео API HappyHorse

| Сценарий использования   | Интерфейс                                                                                         | Описание                                                     |
| :----------------------- | :------------------------------------------------------------------------------------------------ | :----------------------------------------------------------- |
| Текст в видео            | [API генерации](/api/ru/happyhorse/generations)                                                   | Генерация видео из текстового промпта                        |
| Изображение в видео      | \[API преобразования изображения в видео]\(/api/ru/happyhorse/преобразование изображения в видео) | Генерация видео из изображения первого кадра                 |
| Генерация по ссылке      | \[API генерации видео по референсу]\(/api/ru/happyhorse/генерация видео по референсу)             | Генерация видео из нескольких эталонных изображений          |
| Редактирование видео     | [API редактирования видео](/api/ru/happyhorse/video-edit)                                         | Редактирование видео с помощью видео и эталонных изображений |
| Запрос результата задачи | [API получения результата](/api/ru/happyhorse/fetch)                                              | Запрос статуса и результатов асинхронной задачи              |

## Рекомендуемый процесс интеграции

### Текст в видео / Изображение в видео / Генерация по ссылке / Редактирование видео

1. Выберите соответствующий интерфейс генерации в соответствии с вашими потребностями (текст в видео, изображение в видео, генерация по ссылке или редактирование видео)
2. Вызовите соответствующий API генерации для отправки задачи, получите `task_id`
3. Используйте [API получения результата](/api/ru/happyhorse/fetch) для опроса статуса задачи
4. Когда `task_status` станет `SUCCEEDED`, получите URL видео из ответа

### Описание статуса задачи

* `PENDING`: Задача в очереди
* `RUNNING`: Задача выполняется
* `SUCCEEDED`: Задача успешно завершена
* `FAILED`: Задача не удалась
* `CANCELED`: Задача отменена
* `UNKNOWN`: Задача не существует или статус неизвестен

## Почему стоит использовать видео API HappyHorse

* **Множественные режимы генерации**: Поддержка текста в видео, изображения в видео, генерации по ссылке, редактирования видео и многого другого
* **Высококачественный вывод**: Поддержка разрешения 720P/1080P с различными вариантами соотношения сторон
* **Гибкое управление**: Поддержка управления продолжительностью, настройки зерна, переключения водяного знака и других параметров
* **Единый шлюз**: Использование единого API шлюза и механизма аутентификации
* **Полный жизненный цикл**: Предоставление полного рабочего процесса отправки задач, запросов и получения результатов

## Часто задаваемые вопросы по HappyHorse Видео API

### Какой интерфейс лучше всего подходит для новых пользователей?

Мы рекомендуем начать с [API генерации](/api/ru/happyhorse/generations) (текст в видео), который является наиболее базовым и часто используемым интерфейсом.

### В чём разница между Изображение в видео и Генерация по референсу?

* **Изображение в видео**: Генерирует видео на основе одного изображения первого кадра, подходит для сценариев, когда нужно начать с определённого кадра
* **Генерация по референсу**: Генерирует видео на основе нескольких эталонных изображений (1-9), с поддержкой ссылок на персонажей через идентификаторы, такие как character1, character2 и т. д., подходит для сложных сценариев с несколькими персонажами или элементами

### Какие функции поддерживает Редактирование видео?

Поддерживает передачу стиля, частичную замену и другие функции редактирования. Требуется предоставление видео для редактирования (обязательно) и дополнительных эталонных изображений (0-5), описание намерения редактирования через текстовые промпты.

### Как запросить результаты задачи?

Используйте [API получения результата](/api/ru/happyhorse/fetch) для запроса окончательного результата асинхронных задач. Обратите внимание:

* `task_id` действителен в течение 24 часов
* URL видео сохраняется только 24 часа, после истечения срока автоматически удаляется, пожалуйста, своевременно сохраняйте сгенерированные видео

### Какова продолжительность сгенерированных видео?

* Текст в видео / Изображение в видео / Генерация по ссылке: 3-15 секунд (настраивается)
* Редактирование видео: продолжительность выходного видео 3-15 секунд (соответствует входным данным, когда входное видео ≤15 секунд, обрезается до первых 15 секунд, когда входное видео >15 секунд)

### Какие разрешения и соотношения сторон поддерживаются?

* **Разрешение**: 720P, 1080P
* **Соотношение сторон**: 16:9, 9:16, 3:4, 4:3, 1:1