Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
duration_seconds | Нет | Длина ролика. Оплата посекундная. 5 · 8 · По умолчанию: 5 |
image_url | Да | Картинка, с которой всё начинается. |
prompt | Нет | Optional: describe the motion and the camera. Leave it empty to let the model animate the frame on its own. |
resolution | Нет | Размер результата. Больше — чётче и дороже. 480p · 720p · По умолчанию: 720p |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за секунду | ≈ USD |
|---|---|---|
| resolution 480p | 3,6 | 0,036 $ |
| resolution 720p | 7,2 | 0,072 $ |
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API HunyuanVideo 1.5 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model tencent/hunyuan-video-1.5/image-to-video и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "tencent/hunyuan-video-1.5/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "720p",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API HunyuanVideo 1.5
Сколько стоит API HunyuanVideo 1.5?
HunyuanVideo 1.5 стоит от 18 кредитов (0,18 $) за клип длиной 5 с — на самой дешёвой задаче «Видео из картинки». Цены по вариантам: 480p 3,6 кредита за секунду, 720p 7,2 кредита за секунду. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у HunyuanVideo 1.5 в API?
Укажите tencent/hunyuan-video-1.5/text-to-video — Создать видео; tencent/hunyuan-video-1.5/image-to-video — Видео из картинки в поле model запроса POST /jobs/createTask.
Что такое HunyuanVideo 1.5?
Открытая видеомодель команды Hunyuan компании Tencent, выпущенная в ноябре 2025 года. По описанию Tencent, это диффузионный трансформер на 8,3 млрд параметров с 3D-каузальным VAE и схемой внимания, которая пропускает избыточные части видео; модель рассчитана на запуск на потребительских GPU.
Какой длины и размера бывают клипы?
5 или 8 секунд при 24 кадрах в секунду, в 480p или 720p. Text-to-video выдаёт 832 x 480, 480 x 832, 1280 x 720 или 720 x 1280; image-to-video сохраняет форму вашей фотографии.
Генерирует ли она звук?
Нет. Клипы — это немые файлы MP4 без аудиодорожки. Добавьте звук при монтаже или выберите модель, которая генерирует аудио вместе с картинкой.
Нужен ли промпт для image-to-video?
Нет. Здесь промпт не обязателен: без него модель оживит фото сама. Если пишете, описывайте движение и камеру, а не само фото.
Сколько делается клип?
В наших тестах 5-секундный клип в 480p занял примерно от одной до двух с половиной минут времени модели, а 5-секундный клип в 720p — примерно от двух с половиной до четырёх минут.
Какие ограничения у API HunyuanVideo 1.5?
Длина клипа: 5–8 s; Разрешения: 480p · 720p. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать HunyuanVideo 1.5 без кода?
Да. Playground запускает HunyuanVideo 1.5 на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.

