Введение
HunyuanVideo 1.5 Текст в видео превращает текстовый промпт в короткий клип. HunyuanVideo 1.5 — открытая видеомодель Tencent на 8,3 млрд параметров; этот эндпоинт возвращает 5 или 8 секунд в 480p или 720p в альбомной или портретной ориентации, с негативным промптом против артефактов. Платформа не добавляет фильтр контента ни к промпту, ни к клипу.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| текстовое описание | HunyuanVideo 1.5 Текст в видео |
| фото, которое нужно оживить | HunyuanVideo 1.5 Изображение в видео |
Ключевые возможности и особенности
Естественные люди в компактной модели
В модели 8,3 млрд параметров, и всё же в наших тестах лица, кожа, волосы и ткань выглядели фотографично и двигались без «плывущих» форм.
Четыре размера кадра
aspect_ratio и resolution складываются в 832 x 480, 480 x 832, 1280 x 720 или 720 x 1280, так что вертикальные клипы компонуются под экран, а не обрезаются.
Негативный промпт
Перечислите то, что вы не хотите видеть. Это самый быстрый способ убрать лишний текст, кривые руки или размытие.
Без цензуры
Фильтра нет ни на промпт, ни на результат. В наших тестах большинство контентных проб отрисовалось как написано; самая сильная убрала часть сцены.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите, кто в кадре, во что одет и что делает, а также что делает камера. Лучше всего работает одно ясное действие на клип. Не менее 1 символов |
negative_prompt | Нет | Необязательный список того, чего быть не должно, например "blurry, distorted hands, extra limbs, text, watermark". На цену не влияет. |
aspect_ratio | Нет | 16:9 для альбомной ориентации (по умолчанию) или 9:16 для портретной. Форма кадра на цену не влияет. |
resolution | Нет | 480p (832 x 480) или 720p (1280 x 720, по умолчанию). Секунда в 720p стоит вдвое дороже; черновики делайте в 480p. |
duration_seconds | Нет | 5 или 8 секунд, оплата за секунду. |
seed | Нет | Помогает сравнивать запуски, пока вы меняете что-то одно за раз. Идентичного кадр в кадр клипа он не обещает. |
Стоимость
Оплата за секунду результата при выбранном разрешении. Соотношение сторон на цену не влияет.
| Спецификация | Стоимость |
|---|---|
| $0.024 / секунду |
| $0.048 / секунду |
Сценарии использования
Вертикальные клипы для соцсетей
9:16 в 720 x 1280 для лент и сторис.
Исследование промптов
В 480p пятисекундный черновик стоит дёшево, поэтому можно перебрать много промптов, прежде чем разворачивать идею в большем размере.
Клипы без фильтра для вашей платформы
Нет фильтра контента ни на промпт, ни на клип; в кадре только совершеннолетние.
Руководство по промптам и практические советы
Пишите кадр
Герой, одежда, действие, свет, камера — именно в таком порядке, в двух-четырёх предложениях.
Одно действие на клип
Пять секунд — это один жест или одно движение. Цепочки действий сливаются.
Контактные сцены делайте простыми
Двое в контакте склонны путать конечности; помогают медленное движение и более общий план.
Черновик в малом размере
Прогоните идею в 480p с фиксированным seed, затем перезапустите лучший вариант в 720p.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "tencent/hunyuan-video-1.5/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
