О модели MiniMax H3 Edit
MiniMax H3 Edit меняет свет, погоду, стиль или обстановку загруженного клипа, а ваш исходный материал по-прежнему определяет, кто в кадре, композицию и движение. Редактирует 3–15 секунд в 480p, 540p или 768p и по умолчанию добавляет новую звуковую дорожку.
Вызывайте его по имени модели minimax/h3-edit/video-edit через POST /jobs/createTask, от 0,15 $.
Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
aspect_ratio | Нет | Форма кадра: широкая, квадратная или вертикальная. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21 |
duration_seconds | Нет | Длина ролика. Оплата посекундная. ≥ 3 · ≤ 15 · По умолчанию: 5 |
generate_audio | Нет | Добавляет звук под картинку: голоса, атмосферу и эффекты. По умолчанию: true |
prompt | Да | The change to make: lighting, weather, style, setting or specific elements. Name references as <Picture 1> or <Audio 1>. |
reference_audio_urls | Нет | Звук-образец: голос, музыка или ритм. |
reference_image_urls | Нет | Изображения людей, одежды или мест, которые нужно сохранить. |
resolution | Нет | Размер результата. Больше — чётче и дороже. 480p · 540p · 768p · По умолчанию: 768p |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
video_url | Да | Ролик, с которым работаем. |
Цены
Цены указаны в USD. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.
| Вариант | USD за секунду |
|---|---|
| resolution 480p | 0,03 $ |
| resolution 540p | 0,045 $ |
| resolution 768p | 0,066 $ |
До запуска отправьте то же тело запроса в POST /jobs/quote, чтобы узнать ожидаемую и максимальную стоимость в USD. Расчёт не запускает задачу и не списывает деньги.
Быстрый старт API
Вызов API MiniMax H3 Edit в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
- Отправьте запрос. Отправьте POST /jobs/createTask с model minimax/h3-edit/video-edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-edit/video-edit",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"resolution": "768p",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API MiniMax H3 Edit
Сколько стоит API MiniMax H3 Edit?
MiniMax H3 Edit стоит 0,15 $ за клип длиной 5 с. Цены по вариантам: 480p 0,03 $ за секунду, 540p 0,045 $ за секунду, 768p 0,066 $ за секунду. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.
Какое имя модели у MiniMax H3 Edit в API?
Укажите minimax/h3-edit/video-edit — Редактировать видео в поле model запроса POST /jobs/createTask.
Как отредактировать видео с помощью AI одним предложением?
Загрузите клип и опишите изменение одним предложением, а затем то, что должно остаться прежним. Один запрос возвращает новую версию кадра с применённым изменением.
Останутся ли люди и их движение прежними?
Ваш клип задаёт, кто в кадре, композицию и движение, поэтому они переносятся. Небольшие изменения всё же могут появиться, когда промпт описывает движение, поэтому описывайте погоду и свет, а действия оставьте исходнику.
Что делать, если нужен новый клип, а не редактирование?
Используйте MiniMax H3 (/models/minimax-h3), который стартует от написанной сцены, стартового изображения или референсных изображений. Edit нужен, когда у вас уже есть материал и вы хотите, чтобы он выглядел иначе.
Какие ограничения у API MiniMax H3 Edit?
Длина клипа: 3–15 s; Разрешения: 480p · 540p · 768p; Соотношения сторон: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21; Референсное аудио: 3; Референсные изображения: 9. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать MiniMax H3 Edit без кода?
Запускайте MiniMax H3 Edit в Playground с баланса API в USD без API-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.
Все модели MiniMax
Kling O3 тоже редактирует клипы и работает до 4K. H3 Edit — более быстрый и недорогой выбор для смены стиля и погоды.
- MiniMax H3 APIВыразительные клипы со звуком, до 30 секунд или 2KОт 0,125 $ за клип длиной 5 с
- MiniMax Speech 2.8 HD APIРечь высокого качества, 400+ голосов и управление эмоциямиОт 0,12 $ за 1000 символов
- MiniMax Music 3.0 APIГотовые стереотреки — с вокалом или инструментальныеОт 0,18 $ за генерацию
- MiniMax H3 Singularity LoRA APIВидео H3 в доработке сообщества, загружает ваши LoRAОт 0,30 $ за клип длиной 5 с
- MiniMax H3 Max APIБыстрые клипы с атмосферой, эффектами и музыкойОт 0,25 $ за клип длиной 5 с
- MiniMax H3 LoRA APIВидео MiniMax H3 со звуком и до трёх ваших LoRAОт 0,25 $ за клип длиной 5 с
- MiniMax H3 Image LoRA APIКадры и правки H3 с тремя вашими LoRAОт 0,042 $ за изображение
- MiniMax H3 Edit APIМеняет свет, погоду или стиль клипа; люди и движение сохраняютсяОт 0,15 $ за клип длиной 5 с
- MiniMax Speech 2.8 Turbo APIБыстрая речь, 400+ голосов и управление эмоциямиОт 0,072 $ за 1000 символов
- MiniMax H3 360 Orbit APIПолный облёт камеры на 360° вокруг объекта с одного фотоОт 0,25 $ за клип длиной 5 с