Введение
Продление видео в MiniMax H3. Отправьте клип, который хотите продолжить, и опишите, что происходит дальше: последний кадр клипа становится стартовым кадром нового плана image-to-video в MiniMax H3, а оригинал и новый сегмент возвращаются соединёнными в одном MP4. Оплачиваются только новые секунды.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
| Разработчик | MiniMax |
| Эндпоинты | text-to-video, image-to-video, reference-to-video, video-extend |
| Длительность | 4–15 секунд, в text-to-video 5–15 |
| Разрешение | 768p, 2k |
| Соотношения сторон | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 (текст и референсы) |
| Референсы | До 9 изображений |
| Звук | Создаётся вместе с картинкой на каждом эндпоинте |
| Исполнение | Асинхронная задача, оплата по секундам готового видео |
Ключевые возможности и особенности
Готовый кадр из одного абзаца
Опишите, кто в кадре, что происходит, куда движется камера и что слышно. H3 выдаёт свет, зерно, движение и подходящий звук в одном ролике. Эта нуарная сцена у окна — четыре предложения и ничего больше.
Ваш кадр в движении
Начните со статичного кадра и опишите только то, что происходит дальше. Здесь стартовым кадром была чашка кофе на стойке; рука, подъём камеры к рубашке и мужчина, просыпающийся у неё за спиной, — всё это взялось из промпта.
Та же женщина, тот же наряд, новая сцена
Дайте лицо, наряд и комнату отдельными фото, и модель соберёт их в кадр, который вы никогда не снимали. Так персонаж остаётся узнаваемым от ролика к ролику.
Звук рождается вместе с картинкой
Диалог, атмосфера помещения и музыка генерируются за один проход. Спетая строчка, реверберация клуба и гул публики в этом ролике целиком описаны в промпте — без отдельного этапа со звуком.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательное поле. Что происходит дальше: следующее действие, движение камеры и звук. Не менее 1 символов · Не более 7000 символов |
video_url | Да | Клип для продолжения: MP4, MOV или WebM, до 60 секунд. Его последний кадр станет стартовым кадром нового сегмента, поэтому обрежьте его на чётком, чистом кадре. Не менее 1 символов |
last_image_url | Нет | Необязательный целевой финальный кадр: новый сегмент завершается на этом изображении. Он направляет только концовку; середина остаётся свободной. |
resolution | Нет | Разрешение нового сегмента: 768p или 2k, по умолчанию 768p. Оба варианта нативные. |
duration_seconds | Нет | Длина нового сегмента: целые секунды, от 4 до 15; по умолчанию 5. Сегмент в 4 секунды доступен только в 768p, а для 2k нужно не менее 5 секунд. |
Стоимость
Оплата за секунду нового сегмента в выбранном разрешении; отправленный исходный клип не оплачивается. Неудавшаяся генерация или соединение, которое не удалось собрать, возвращается полностью.
| Спецификация | Стоимость |
|---|---|
| $0.037 / секунду |
| $0.058 / секунду |
Сценарии использования
Сцены без цензуры, от которых отказываются другие видео-API
Сцены, которые блокируют другие API, проходят с первой попытки, а не упираются в фильтр промптов. Опишите сцену для режима «текст в видео» или сначала сгенерируйте нужного человека и анимируйте этот кадр, когда образ должен быть точным.
Вертикальные ролики со звуком для соцсетей
Ролики 9:16 уже со звуком: десятисекундный тизер, атмосферная петля, момент реакции. Делайте черновики в 768p, пока не сложится тайминг, а лучший дубль перегенерируйте в 2K.
Сквозной персонаж на всю серию
Держите одно лицо, один образ и одну комнату неизменными от эпизода к эпизоду с помощью референсных фото и описывайте только то, что меняется в новом кадре.
Длинные сцены, кадр за кадром
Склеивайте 15-секундные ролики в целую сцену: последний кадр каждого одобренного ролика становится первым кадром следующего, так что одежда, декорации и свет переходят через склейку.
Руководство по промптам и практические советы
Попробуйте в песочнице
Выберите режим выше — фразу, свой стартовый кадр или несколько референсных фото, — вставьте один из промптов с этой страницы и запустите. Точная цена видна до того, как что-либо спишется.
Получите API-ключ
Зарегистрируйтесь, пополните баланс картой или криптовалютой и создайте ключ в консоли. Подписки нет: вы платите за секунды созданного видео.
Отправьте тот же запрос из своего кода
Скопируйте запрос со вкладки API — это то же тело, которое только что выполнила песочница. Готовый ролик придёт на ваш вебхук, или вы получите его по ID задачи.
Введение
MiniMax H3 Продление видео продолжает клип, который у вас уже есть. Отправьте его как video_url вместе с промптом о том, что происходит дальше. Последний кадр клипа становится стартовым кадром нового плана image-to-video в MiniMax H3 длиной от 4 до 15 секунд, и оба фрагмента соединяются в один MP4: сначала ваш оригинал, затем продолжение, без повторного кадра на стыке. Новый сегмент также возвращается отдельным файлом, так что вы можете продолжать продление или редактировать части по отдельности.
Ключевые возможности
Непрерывность идёт от последнего кадра
Одежда, обстановка, свет и расположение всех персонажей сохраняются, потому что новый сегмент буквально начинается с вашего последнего кадра. Движение так не переносится: модель видит один неподвижный кадр, а не весь клип, поэтому опишите движение, которое нужно продолжить, а не рассчитывайте, что оно сохранит скорость или направление.
Один файл в ответ и новый фрагмент отдельно
Склеенный MP4 сохраняет частоту кадров и кадрирование вашего клипа, без чёрных полос. Чтобы стык совпал, изображение по краям может быть обрезано или слегка изменено на несколько процентов. Если модель вернёт заметно другие пропорции, новый сегмент масштабируется так, чтобы заполнить ваш кадр, выравнивается по центру, а всё, что выходит за края, обрезается. Новый сегмент приходит со звуком, сгенерированным за один проход; звук вашего исходника сохраняется, а стык плавно сводится за долю секунды. Если одна сторона без звука, другая дополняется тишиной. Второй выходной файл — это только новый сегмент с ролью segment, готовый к следующему продлению или к монтажу.
Необязательный финальный кадр
last_image_url необязателен. Передайте изображение, и новый сегмент завершится на нём; без него концовка свободная. Финальный кадр подтягивает только концовку, и чем длиннее сегмент, тем дальше середина может от него отойти. Сегмент в 4 секунды доступен только в 768p, а для 2k нужно не менее 5 секунд.
Всё остальное — это image-to-video в MiniMax H3
Новый сегмент идёт по тем же маршрутам, с тем же диапазоном содержимого и по той же цене за секунду, что и эндпоинт 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/video-extend",
"input": {
"duration_seconds": 5,
"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.
