Введение
API MiniMax H3 Lite для генерации видео из изображения превращает статичный кадр в клип со звуком длиной 4–15 секунд в 480p или 768p. Отправьте первый кадр, при желании финальный, и проверьте движение в 480p, прежде чем платить за более чёткий рендер. Облегчённая версия подходит для проверки идей и создания нескольких вариантов. Один запрос даёт ровно один MP4, где изображение и звук создаются одновременно.
Выберите режим по исходным материалам
| Ваша отправная точка | Какой режим открыть |
|---|---|
| только идея | MiniMax H3 Lite: текст в видео |
| кадр для анимации, с необязательным последним кадром | MiniMax H3 Lite: изображение в видео |
| люди, образы, места, клипы движения или голоса | MiniMax H3 Lite: референсы в видео |
Ключевые возможности и особенности
Исходный кадр задаёт картинку
Первый кадр фиксирует лица, одежду, свет и композицию, поэтому MiniMax H3 Lite тратит промпт на то, что движется. Клип повторяет форму вашего кадра, а поля соотношения сторон нет, поэтому перед загрузкой обрежьте изображение до горизонтального или вертикального формата.
Необязательный последний кадр
Отправьте второе изображение как last_image_url, и клип придёт в покой на нём: два статичных кадра превращаются в управляемый переход. Вместо того чтобы придумывать концовку, модель планирует движение между двумя картинками, что помогает, когда один кадр должен перейти в другой.
Звук включён
Движение приходит с подходящим звуком: прибой, шаги, смех или реплика в кавычках — всё генерируется вместе с картинкой без доплаты. Добавьте строку Audio:, если хотите определённый стиль музыки или акустику комнаты вместо того, что подсказывает сцена.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязателен, до 7 000 символов; более длинный текст отклоняется. Реплики заключайте в двойные кавычки. Не менее 1 символов · Не более 7000 символов |
image_url | Да | Обязательный начальный кадр. Клип сохраняет его форму. |
last_image_url | Нет | Необязательный конечный кадр; клип завершается на нём. На цену не влияет. |
resolution | Нет |
|
duration_seconds | Нет | Целое число секунд, от 4 до 15, по умолчанию 5. Оплата за секунду вместе с разрешением. |
Стоимость
Оплата за секунду вывода в выбранном разрешении. Актуальную цену смотрите на странице модели.
| Спецификация | Стоимость |
|---|---|
| $0.025 / секунду |
| $0.04 / секунду |
Сценарии использования
Фото товаров и одежды, которые двигаются
Каталожный снимок куртки, сумки или пары обуви может открыть короткий клип на MiniMax H3 Lite: модель идёт, поворачивается или берёт вещь, а свет исходной съёмки сохраняется, что избавляет от переснимки для простых движений.
Оживление портрета
Один портрет становится коротким клипом с естественным движением и звуком на MiniMax H3 Lite, без описания образа с нуля. Одной улыбки, поворота головы или шага к камере часто хватает, чтобы оживить аватар или карточку персонажа.
Управляемые переходы
С первым и последним кадром MiniMax H3 Lite заполняет движение между двумя статичными изображениями: это полезно для снимков «до и после», смены образа или сюжетных моментов, когда персонаж начинает в одной позе и заканчивает в другой.
Руководство по промптам и практические советы
Описывайте следующий момент, а не картинку
Кадр уже показывает, кто и где. Оставьте промпт для действия, движения камеры и звука, которые следуют дальше, в том порядке, в каком они происходят. Повторное описание картинки чаще всего её замораживает, а понятное первое действие, например «она поворачивается к окну», запускает движение.
Используйте кадры в пределах ограничений
Кадры должны быть от 256 до 5 760 пикселей по каждой стороне с соотношением ширины к высоте от 0,4 до 2,5; экстремальные панорамы обрежьте до отправки. Чёткий, хорошо освещённый кадр с хорошо видимым героем сохраняет лица устойчивее, чем маленькое или сильно сжатое изображение.
Подбирайте согласованные кадры
Последний кадр работает лучше всего, если на нём те же люди и помещение, что и в первом, с изменением, которое можно объяснить в промпте: новая поза, шаг ближе или другое выражение. Два несвязанных снимка дают скачок, похожий на монтажную склейку.
Оплата за секунду вывода в выбранном разрешении. Актуальную цену смотрите на странице модели.
Быстрый старт 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": "minimax/h3-lite/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p"
}
}'
# 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.
















