MiniMax H3 Edit API

MiniMax H3 Редактирование видео берёт готовый клип, отправленный как video_url, и промпт, который описывает изменение. Он возвращает новую версию того же плана: от 3 до 15 секунд в 480p, 540p или 768p, по умолчанию с новой звуковой дорожкой. Ваш материал по-прежнему задаёт, кто в кадре, композицию и движение; промпт переписывает освещение, погоду, стиль, окружение или отдельные элементы. Можно добавить до девяти референсных изображений и до трёх референсных аудиоклипов, которые задают личность, стиль или звук.

Выберите режим MiniMax H3 по исходному материалу

Ваш клип по-прежнему задаёт людей и движение

Исходник определяет, кто попадает в кадр, как он выстроен и как движется каждый. Промпт определяет, как выглядит окружающий мир. Именно это разделение отличает редактирование от генерации нового кадра: сцену заново не описываете, только изменение. Исходный клип может быть длиной до 15 секунд; более длинный отклоняется ещё до списания средств, поэтому сначала обрежьте его.

Солнечная терраса, превращённая в шторм

Для тестового прогона мы взяли пятисекундный клип 1280x720 из наших примеров OmniHuman 2.0: женщина в кремовом атласном плаще на солнечной приморской террасе. Промпт просил штормовые сумерки с тёмными тучами, дождём, далёкой молнией и с мокрыми, развевающимися на ветру волосами и плащом, и заканчивался фразой «Keep her face, pose and movement.» При 768p с duration_seconds 5 и включённым звуком результат получился 1344x768 при 24 fps, около 5,2 секунды, с новым звуком, примерно через три минуты обработки.

Что изменилось: солнечное небо стало тёмными облачными сумерками со вспышкой молнии над морем, а камень выглядел мокрым. Что осталось: её лицо, плащ и улыбка. Стоит честно ожидать две вещи. Сам дождь при 768p был лёгким, а пробный прогон того же промпта в 480p дал более сильные дождевые полосы. И она подняла руку к волосам, такого жеста в исходном клипе не было. Промпт упоминал волосы на ветру, поэтому описание движения может принести с собой небольшие изменения в движении.

Референсы называются номерами

reference_image_urls принимает до девяти изображений, которые в промпте называются от <Picture 1> до <Picture 9>, а reference_audio_urls принимает до трёх аудиоклипов, которые называются от <Audio 1> до <Audio 3>. Изображение используйте для образа или личности, аудиоклип — для нужного звука. Каждый референс добавляет небольшую плату. Мы ещё не запускали этот эндпоинт с референсами, поэтому первый дубль с ними считайте тестом: начните с одного изображения или одного клипа и посмотрите, что он меняет.

Звук, длина и формат

generate_audio включён по умолчанию, и тогда у редактирования появляется новая звуковая дорожка. Выключите его, чтобы сохранить собственную аудиодорожку исходного клипа. Звук цену не меняет. duration_seconds идёт от 3 до 15 и по умолчанию равен 5, поэтому укажите длину исходника, чтобы отредактировать клип целиком. Если не задавать aspect_ratio, редактирование сохранит формат исходника; укажите 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 или 9:21, чтобы перекадрировать.

Три разрешения

768p — значение по умолчанию и родное разрешение H3. 540p и 480p стоят меньше за секунду и раньше готовятся. Мы запускали 768p и пробный прогон в 480p; 540p мы не пробовали. Вы платите за секунды редактирования плюс за секунды исходника, обе по ставке выбранного разрешения, поэтому более короткий исходник обходится дешевле.

Смените погоду, свет или время суток

Превратите яркий день в сумерки, добавьте дождь или замените резкое полуденное солнце мягким утренним светом, как в примере с террасой. Поскольку люди и движение берутся из вашего клипа, на одном дубле можно попробовать несколько настроений, а не снимать заново.

Смена стиля готового клипа

Попросите другой стиль, сезон или обстановку и сохраните исполнение. Назовите, что должно остаться, например лицо, позу и движение. Пока мы тестировали погоду и свет; смена стиля и обстановки — то, для чего создан эндпоинт, но прежде чем на это полагаться, проверьте черновик.

Измените один элемент

Направьте промпт на конкретный элемент, например на цвет пальто или предмет в кадре, и напишите, что всё остальное остаётся как есть. Сначала запустите черновик и посмотрите на те части, которые вы не просили менять.

# 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-edit/video-edit",
  "input": {
    "duration_seconds": 5,
    "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.