Введение
Изображение в видео на MiniMax H3 HighSpeed берёт готовый неподвижный кадр и оживляет его в MP4 длиной 4–15 секунд в 768p со звуком. Внешний вид задаёт картинка, а в промпте нужно лишь сказать, что движется.
Выберите режим по исходным материалам
| Что у вас есть | Режим |
|---|---|
| только идея | MiniMax H3 HighSpeed: текст в видео |
| кадр для анимации, с необязательным последним кадром | MiniMax H3 HighSpeed: изображение в видео |
| люди, образы, места, клипы движения или голоса | MiniMax H3 HighSpeed: референсы в видео |
Ключевые возможности и особенности
Исходный кадр задаёт картинку
Лица, одежда, свет и композиция берутся из вашего начального кадра. Клип сохраняет его форму, а поля соотношения сторон нет, поэтому перед отправкой обрежьте картинку до нужного формата — горизонтального или вертикального.
Необязательный последний кадр
Добавьте last_image_url, и клип остановится на этом втором кадре — так вы управляете движением между двумя неподвижными картинками. Это помогает, когда один план должен чисто перейти в следующий.
Звук включён
Движение приходит с подходящим звуком — прибоем, шагами, смехом или репликой в кавычках — без доплаты. Строка Audio: в промпте задаёт стиль музыки или звук помещения.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательно. Принимает от 1 до 7 000 символов, более длинный текст отклоняется. Не менее 1 символов · Не более 7000 символов |
image_url | Да | Обязательный начальный кадр, форму которого повторяет клип. Каждая сторона — от 256 до 5 760 пикселей, отношение ширины к высоте — от 0,4 до 2,5. |
last_image_url | Нет | Необязательный конечный кадр, на котором клип останавливается. К цене ничего не добавляет. |
resolution | Нет |
|
duration_seconds | Нет | Целое число от 4 до 15 (по умолчанию 5), каждая секунда оплачивается по тарифу 768p. Запрос на 4 секунды вернулся клипом в 3,75 секунды. |
Стоимость
Оплачивается каждая секунда готового клипа в 768p; актуальная цена указана на странице модели.
| Спецификация | Стоимость |
|---|---|
| $0.072 / секунду |
Сценарии использования
Фото товаров и одежды, которые двигаются
Каталожное фото куртки, сумки или пары обуви может стать началом короткого клипа, где вещь надевают, поворачивают или берут в руки, при том же освещении, что и в исходной съёмке.
Оживление портрета
Один портрет превращается в короткий клип с улыбкой, поворотом головы или шагом к камере — этого достаточно, чтобы оживить аватар или карточку персонажа.
Управляемые переходы
С начальным и конечным кадрами модель достраивает движение между ними: кадры «до и после», смену образа или персонажа, который начинает в одной позе и заканчивает в другой.
Руководство по промптам и практические советы
Описывайте следующий момент, а не картинку
Используйте промпт, чтобы добавить к кадру короткую последовательность: товар поворачивается к этикетке, портрет поднимает взгляд, камера медленно приближается. Сначала действие, затем камера, затем звук.
Используйте кадры в пределах ограничений
Держите каждую сторону в пределах 256–5 760 пикселей, а отношение ширины к высоте — от 0,4 до 2,5. На выходе форма вашего кадра сохраняется в 768p, поэтому перед публикацией проверьте в результате лица, этикетки и края.
Подбирайте согласованные кадры
Задайте начальному и конечному кадрам одинаковую композицию и соотношение сторон и продумайте один переход, который уложится в 4–15 секунд. Посмотрите последнюю секунду, чтобы убедиться, что план приходит именно к конечному кадру.
Оплачивается каждая секунда готового клипа в 768p; актуальная цена указана на странице модели.
Быстрый старт 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-highspeed/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.
