Введение
Продление видео в MiniMax H3 Max. Отправьте клип, который хотите продолжить, и опишите, что происходит дальше: последний кадр клипа становится стартовым кадром нового плана image-to-video в MiniMax H3 Max, а оригинал и новый сегмент возвращаются соединёнными в одном MP4. Оплачиваются только новые секунды.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
| Разработчик | MiniMax |
| Эндпоинты | text-to-video, image-to-video, video-extend |
| Длительность | 5–15 секунд, только целые, по умолчанию 8 |
| Разрешение | 480p, 768p (по умолчанию) |
| Соотношения сторон | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 (text-to-video; по умолчанию 1:1) |
| Управление кадрами | Стартовый кадр обязателен в image-to-video, финальный необязателен |
| Звук | Генерируется вместе с картинкой |
| Исполнение | Асинхронная задача, оплата по секундам готового видео |
Ключевые возможности и особенности
Чтобы быстро превратить бриф в клип
MiniMax позиционирует H3 Max как вариант H3 для быстрой генерации, оптимизированный под скорость. Здесь он работает в 480p или 768p со звуком в том же проходе, что подходит для цикла «написать, отрендерить, поправить». Клипы начинаются с пяти секунд, так что даже самый короткий запрос — уже пригодный фрагмент, а не пробный кадр.
Скажите, где план начинается и куда приходит
Image-to-video принимает стартовый кадр и, по желанию, финальный. Оба конца тогда закреплены, и генерируется только движение между ними — удобно, когда клип обязан чисто встать в монтаж. Кадры должны быть согласованы по субъекту, костюму и свету, иначе середина клипа заметно мечется между ними.
Задайте формат кадра, прежде чем оценивать дубль
У text-to-video по умолчанию 1:1, поэтому широкоформатный бриф вернётся квадратным, если aspect_ratio не задан иначе: выставьте 21:9, 16:9, 4:3, 3:4 или 9:16, прежде чем сравнивать дубли. У image-to-video поля aspect_ratio нет: форму задаёт стартовый кадр, так что обрежьте изображение до отправки.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
last_image_url | Нет | Необязательный целевой финальный кадр: новый сегмент завершается на этом изображении. Он направляет только концовку; середина остаётся свободной. |
prompt | Да | Обязательное поле. Что происходит дальше: следующее действие, движение камеры и звук. Не менее 1 символов · Не более 7000 символов |
duration_seconds | Нет | Длина нового сегмента: целые секунды, от 5 до 15; по умолчанию 8. Ваш исходник добавляется спереди и не оплачивается. |
resolution | Нет | Разрешение нового сегмента: 480p или 768p, по умолчанию 768p. Оба варианта нативные. |
enable_prompt_expansion | Нет | По умолчанию выключено, поэтому промпт используется в том виде, в каком вы его написали. По умолчанию: |
video_url | Да | Клип для продолжения: MP4, MOV или WebM, до 60 секунд. Его последний кадр станет стартовым кадром нового сегмента, поэтому обрежьте его на чётком, чистом кадре. Не менее 1 символов |
Стоимость
Оплата за секунду нового сегмента в выбранном разрешении; отправленный исходный клип не оплачивается. Неудавшаяся генерация или соединение, которое не удалось собрать, возвращается полностью. Включение расширения промпта добавляет фиксированную плату за запрос.
| Спецификация | Стоимость |
|---|---|
| $0.05 / секунду |
| $0.08 / секунду |
Сценарии использования
Ключевые планы от утверждённого кадра
Когда сцена утверждена, сначала сгенерируйте стартовый кадр и отправьте его в image-to-video: задуманные костюм, телосложение и лицо сохранятся, а не будут придумываться заново при каждом прогоне.
Анаморфный рекламный фильм
21:9 с медленным шагом на камеру, жёстким контровым светом и ветродуем — та грамматика фэшн-фильма, в которой ступень сильна. Один запрос на 15 секунд покрывает полный такт «подход и остановка», поэтому шва, который надо прятать в монтаже, не остаётся.
Вертикальные версии из того же брифа
Тот же описанный план перезапускается в 9:16 для лент и в 1:1 для квадратных размещений. Оставьте промпт и длительность без изменений, меняйте только соотношение сторон и посмотрите, как работает новое кадрирование, прежде чем делать весь набор форматов.
Клипы, которые обязаны встать в монтаж
Когда план должен начаться на одном кадре раскадровки и закончиться на другом, передайте оба как image_url и last_image_url. Сгенерированное движение приходит в финальную композицию, поэтому уходящий кадр совпадает со следующим планом на таймлайне.
Руководство по промптам и практические советы
Выберите между текстом и первым кадром
Написанная идея идёт в text-to-video; согласованный снимок — в image-to-video, который следует ему куда буквальнее. Наборы полей у эндпоинтов разные: у image-to-video нет
aspect_ratio, потому что форму решает стартовый кадр.Опишите план, затем задайте кадр
Опишите субъект, движение, свет и звук в порядке их появления и задайте
aspect_ratioсами, потому что по умолчанию идёт 1:1. Рабочий бриф выглядит так: «High-fashion campaign film. An adult model in a liquid-silver slip gown walks slowly toward camera down a black marble corridor, the fabric catching hard rim light and rippling with each step, hair moving in a wind machine, she stops and looks straight down the lens. Anamorphic 2.39:1, deep blacks, glossy specular highlights, low synth drone.»Меняйте по одному параметру
Меняйте за один прогон только одно, чтобы каждый результат отражал лишь вашу правку, и пишите важные детали в промпт, а не оставляйте модели пробелы для заполнения. Звук создаётся вместе с картинкой, поэтому любые пометки о музыке или звуке помещения идут в тот же промпт.
Введение
MiniMax H3 Max Продление видео продолжает клип, который у вас уже есть. Отправьте его как video_url вместе с промптом о том, что происходит дальше. Последний кадр клипа становится стартовым кадром нового плана image-to-video в MiniMax H3 Max длиной от 5 до 15 секунд, и оба фрагмента соединяются в один MP4: сначала ваш оригинал, затем продолжение, без повторного кадра на стыке. Новый сегмент также возвращается отдельным файлом, так что вы можете продолжать продление или редактировать части по отдельности.
Ключевые возможности
Непрерывность идёт от последнего кадра
Одежда, обстановка, свет и расположение всех персонажей сохраняются, потому что новый сегмент буквально начинается с вашего последнего кадра. Движение так не переносится: модель видит один неподвижный кадр, а не весь клип, поэтому опишите движение, которое нужно продолжить, а не рассчитывайте, что оно сохранит скорость или направление.
Один файл в ответ и новый фрагмент отдельно
Склеенный MP4 сохраняет частоту кадров и кадрирование вашего клипа, без чёрных полос. Чтобы стык совпал, изображение по краям может быть обрезано или слегка изменено на несколько процентов. Если модель вернёт заметно другие пропорции, новый сегмент масштабируется так, чтобы заполнить ваш кадр, выравнивается по центру, а всё, что выходит за края, обрезается. Новый сегмент приходит со звуком, сгенерированным за один проход; звук вашего исходника сохраняется, а стык плавно сводится за долю секунды. Если одна сторона без звука, другая дополняется тишиной. Второй выходной файл — это только новый сегмент с ролью segment, готовый к следующему продлению или к монтажу.
Необязательный финальный кадр
last_image_url необязателен. Передайте изображение, и новый сегмент завершится на нём; без него концовка свободная. Финальный кадр подтягивает только концовку, и чем длиннее сегмент, тем дальше середина может от него отойти.
Всё остальное — это image-to-video в MiniMax H3 Max
Новый сегмент идёт по тем же маршрутам, с тем же диапазоном содержимого и по той же цене за секунду, что и эндпоинт image-to-video, а неудавшаяся генерация возвращается так же. Если генерация прошла, но соединение собрать не удалось, задача завершается ошибкой, а оплата возвращается.
Сценарии использования
Удлинить план, который закончился слишком рано
Поворотный столик с товаром, который останавливается раньше, чем этикетка повернётся к камере, или проход, обрезанный до того, как герой дойдёт до двери. Продлите на несколько секунд и опишите только оставшееся движение.
Собрать длинную последовательность шаг за шагом
Один запрос даёт не более 15 секунд. Чтобы уйти дальше, сгенерируйте первый план, продлите его, а затем продлите соединённый результат ещё раз; каждый шаг оплачивает только добавленные секунды. Поскольку каждый шаг начинается с одного кадра, проверяйте каждый стык, прежде чем добавлять следующий.
Гайд по промптам и практические советы
Опишите следующий такт, а не всю сцену
Кадр уже задаёт, кто и где, поэтому тратьте промпт на следующее действие, движение камеры и звук. Повторите язык камеры, которым закончился клип, например медленный наезд или статичный кадр, чтобы стык выглядел как один дубль.
Обрежьте перед продлением
Последний кадр — единственное, что видит модель, поэтому размытая концовка, обрыв посреди движения или сильное сжатие переходят прямо в продолжение. Сначала обрежьте исходник на чётком, чистом кадре. Исходники до 60 секунд принимаются в форматах MP4, MOV и WebM.
Сохраняйте согласованное разрешение
Разрешение определяет только чёткость, с которой создаётся новый сегмент, поэтому более низкая настройка делает новую часть мягче оригинала. Подберите разрешение по исходнику и задайте duration_seconds ровно на нужную длину: оплачивается только новый сегмент.
Быстрый старт 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-max/video-extend",
"input": {
"duration_seconds": 8,
"enable_prompt_expansion": false,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.
