HappyHorse 1.1 Видео по референсам API: видео 1080p

Name: HappyHorse 1.1 API
SKU: alibaba/happyhorse-1.1/reference-to-video
Price: 1.05 USD
Availability: InStock

Пока это руководство есть только на английском. →

Параметры запроса

Параметр	Обязательный	Описание
`aspect_ratio`	Нет	Форма кадра: широкая, квадратная или вертикальная. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 4:5 · 5:4 · 9:21 · 21:9 · По умолчанию: 16:9
`duration_seconds`	Нет	Длина ролика. Оплата посекундная. ≥ 3 · ≤ 15 · По умолчанию: 5
`prompt`	Да	Describe the scene, action, camera movement, and timing.
`reference_image_urls`	Да	Изображения людей, одежды или мест, которые нужно сохранить.
`resolution`	Нет	Размер результата. Больше — чётче и дороже. 720p · 1080p · По умолчанию: 720p
`seed`	Нет	Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647

Цены

Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.

Вариант	Кредиты за секунду	≈ USD
resolution 720p	21	0,21 $
resolution 1080p	27	0,27 $

Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.

Быстрый старт API

Вызов API HappyHorse 1.1 в три шага

Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
Отправьте запрос. Отправьте POST /jobs/createTask с model alibaba/happyhorse-1.1/reference-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": "alibaba/happyhorse-1.1/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "aspect_ratio": "16:9",
    "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 HappyHorse 1.1

Сколько стоит API HappyHorse 1.1?

HappyHorse 1.1 стоит от 105 кредитов (1,05 $) за клип длиной 5 с — на самой дешёвой задаче «Видео по референсам». Цены по вариантам: 720p 21 кредит за секунду, 1080p 27 кредитов за секунду. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.

Какое имя модели у HappyHorse 1.1 в API?

Укажите alibaba/happyhorse-1.1/text-to-video — Создать видео; alibaba/happyhorse-1.1/image-to-video — Видео из картинки; alibaba/happyhorse-1.1/reference-to-video — Видео по референсам в поле model запроса POST /jobs/createTask.

Сколько референсных изображений принимает HappyHorse 1.1?

От одного до девяти в reference-to-video, и там это поле обязательно. Отправляйте их в том порядке, в каком к ним обращается prompt, и давайте каждому изображению одну задачу: девять перекрывающихся ракурсов одного субъекта усредняются, а не сводятся.

Какие соотношения сторон доступны?

Девять: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 и 21:9, по умолчанию 16:9. Они открыты в text-to-video и reference-to-video; image-to-video берёт форму у стартового кадра.

Генерирует ли HappyHorse 1.1 звук?

Да. Клипы приходят со сгенерированной звуковой дорожкой, хотя поля аудио нет ни у одного из трёх эндпоинтов, так что отключить её нельзя. Описывайте нужный звук в промпте, а если клип идёт под ваш собственный микс, заглушите или замените дорожку в монтаже.

Можно закрепить последний кадр клипа?

Нет. Поля финального кадра в image-to-video нет — только image_url. Если план обязан прийти в конкретную композицию, сделайте её стартовым кадром обратного движения или перейдите к ней склейкой в монтаже.

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

720p и 1080p, по умолчанию 720p на каждом эндпоинте. Черновики гоняйте в 720p, а нужный дубль перезапустите в 1080p — каждый проход рисует свой дубль, поэтому закрепляйте формулировку, а не ждите тех же кадров.

Какие ограничения у API HappyHorse 1.1?

Длина клипа: 3–15 s; Разрешения: 720p · 1080p; Соотношения сторон: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 4:5 +3; Референсные изображения: 9; Длина промпта (символов): 2,500. Запросы за пределами этих ограничений отклоняются до любого списания.