Введение
HappyHorse 1.1 Референсы в видео собирает один план из одного–девяти референсных изображений, которые отправляются в reference_image_urls в том порядке, в каком их упоминает промпт. Он возвращает от 3 до 15 целых секунд в 720p или 1080p в любом из девяти соотношений сторон со сгенерированным саундтреком. Референсы — только изображения; видео- и аудиореференсы не принимаются.
Выберите режим по исходному материалу
| Исходный материал | Режим |
|---|---|
| написанная сцена или сценарий | HappyHorse 1.1 Текст в видео |
| утверждённое стартовое изображение | HappyHorse 1.1 Изображение в видео |
| от одного до девяти референсных изображений | HappyHorse 1.1 Референсы в видео |
Ключевые возможности и особенности
Девять упорядоченных слотов
С девятью изображениями один запрос может закрепить персонажа, элементы костюма, транспорт, локацию и реквизит. Пример rider-jacket-bike-station тремя кадрами удерживает от дубля к дублю одинаковыми мотоциклиста, распахнутую куртку, мотоцикл и заправку, в 3:4 и 720p, так что промпту остаётся назвать действие и свет.
Лицо, реквизит и место в одном дубле
Пример three-plate-corridor даёт каждому изображению свою задачу: женщина, вишнёво-красная гитара в её руках и неоновый мотельный коридор. Промпт говорит, какое изображение за что отвечает, и затем просит один дубль с камерой, отъезжающей назад, в котором лицо, реквизит и место должны уцелеть вместе.
Девять форматов кадра и на этом эндпоинте
aspect_ratio предлагает девять значений с 16:9 по умолчанию, среди них 1:1, 4:5 и 5:4. Пример product-in-place квадратный, в 1080p: баночка свечи с одного изображения стоит на мраморной полке с другого и освещена в тон оконному свету полки.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Называйте каждый референс [Image 1], [Image 2] и так далее — в порядке загрузки и с квадратными скобками, — скажите, что он вносит, затем опишите кадр, который они должны дать. Не менее 1 символов · Не более 2500 символов |
reference_image_urls | Да | Обязателен: от одного до девяти изображений в том порядке, в каком их называет prompt. По одной задаче на изображение. Не менее 1 элементов · Не более 9 элементов |
aspect_ratio | Нет | Девять значений, по умолчанию 16:9. Доступен здесь, но не в image-to-video. |
resolution | Нет | 720p или 1080p. |
duration_seconds | Нет | Целые секунды, от 3 до 15. |
seed | Нет | Целое число от 0 до 2147483647 для случайного старта; без него каждый прогон берёт своё. |
Стоимость
| Спецификация | Стоимость |
|---|---|
| $0.14 / секунду |
| $0.18 / секунду |
Сценарии использования
Продукт в своей среде
Отправьте продукт и место отдельными изображениями и опишите, как они взаимодействуют. В product-in-place камера медленно наезжает, пока загорается фитиль и поднимается струйка дыма, а тёплое сияние пламени добавляет второй источник света на мрамор и лён.
Один и тот же каст и гардероб на всю серию
Используйте один набор референсов для каждого плана, чтобы исполнитель, костюм и транспорт не менялись от дубля к дублю, и меняйте только строку действия в промпте. Отправляйте изображения каждый раз в одном порядке, чтобы ссылки по позиции продолжали указывать на нужную картинку.
Работа с персонажем без цензуры или в стилизации
Как и image-to-video, этот путь следует переданным изображениям. Работу с персонажем без цензуры, которую text-to-video отклонил бы, можно начать с набора референсов, где каст, гардероб и место закреплены каждый своим изображением.
Руководство по промптам и практические советы
Называйте изображения по позиции
Скажите, что даёт каждое изображение, прежде чем описывать план. Опубликованные примеры используют два позиционных стиля: «Use the woman from the first image exactly as she appears» и «Place the candle jar from [Image 1] into the empty centre of the marble shelf in [Image 2]». Загружайте файлы в том же порядке, в каком их называет промпт.
Одна задача на изображение
Девять слотов — потолок, а не цель. Несколько ракурсов одного и того же объекта усредняются, а не согласуются, поэтому давайте каждому изображению отдельную задачу: личность, предмет одежды, реквизит или место. Каждому изображению нужна короткая сторона не меньше 400 px и размер до 20 МБ.
Тратьте промпт на действие и свет
Когда референсы закрепили личность, промпт говорит, что объект делает, а не как выглядит: «he swings a leg over the tank and settles, the overhead light pressing down from directly above, moths in the beam». Держите указания по свету в согласии с изображением места — так product-in-place повторяет направление и цветовую температуру света на полке.
Быстрый старт 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": "alibaba/happyhorse-1.1/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"resolution": "720p"
}
}'
# 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.
