Введение
MiniMax H3 Character Swap Video edit переодевает одного человека в коротком клипе в персонажа с одного изображения.
Ключевые возможности и особенности
- Отправьте клип, изображение персонажа и того, кого нужно заменить; платформа формирует инструкцию, на которой обучен адаптер («Replace ... with the character in the picture; keep the reference character's face, hair and clothing; follow the source performance's pose, gaze, expression and movement; preserve the scene and the other people»).
- Адаптер Character Swap V1.5 загружается с силой 1.
- С адаптером замена следовала за исходной игрой такт за тактом; та же базовая модель без адаптера теряла игру на полпути и однажды оставила исходного мужчину в кадре как прохожего.
- В кадре с двумя людьми менялся только названный человек.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Исходный клип (MP4). Используются до 15 секунд; лучше всего работает один непрерывный кадр без склеек. Не менее 1 символов |
image_url | Да | Одно изображение нового персонажа: фото, 3D-рендер или рисунок. Фигура в полный рост на простом фоне даёт лучшее совпадение лица, волос и наряда. Не менее 1 символов |
prompt | Нет | Кого заменить, в нескольких словах, например «женщина слева» или «мужчина в белой рубашке». Оставьте пустым, чтобы заменить главного персонажа. Не более 300 символов |
aspect_ratio | Нет | Форма результата (по умолчанию 16:9). Выбирайте ту же форму, что у исходного клипа. |
resolution | Нет | 480p (по умолчанию), 540p, 768p или 1080p. Более высокие уровни стоят дороже за секунду; 480p — дешёвый способ сначала проверить замену. |
duration_seconds | Нет | Длина результата от 3 до 15 секунд (по умолчанию 5). Задайте длину вашего клипа, чтобы использовалась вся игра. |
seed | Нет | Помогает сравнивать запуски, когда вы меняете один вход за раз. Не гарантирует покадрово одинаковый клип. |
Стоимость
Оплата за каждую секунду результата плюс за каждую секунду исходного видео (учитывается каждая начатая секунда, до 15), и небольшая плата за изображение персонажа; ставка зависит от разрешения.
| Спецификация | Стоимость |
|---|---|
| $0.06 / секунду |
| $0.09 / секунду |
| $0.12 / секунду |
| $0.24 / секунду |
Сценарии использования
- Переназначить исполнителя с подписанным релизом на другой образ в том же дубле.
- Поместить сгенерированного вами синтетического персонажа в снятую вами игровую съёмку.
- Быстрые превью идей костюма или кастинга перед пересъёмкой.
Руководство по промптам и практические советы
- Нарисованные и 3D-референсы выходят живыми людьми с теми же волосами, цветами и нарядом.
- В некоторых прогонах остаётся наряд исходника, лицо уходит от референса или появляются лишние статисты в фоне; перезапустите с другим seed или другим клипом.
- Используйте только материалы и внешность, на обработку которых у вас есть разрешение: вы сами, исполнитель с подписанным релизом или синтетический человек, которого вы сгенерировали. Не используйте сервис, чтобы поместить реального человека в интимный или порочащий материал без его явного и осознанного согласия, чтобы выдавать себя за кого-либо и на любом материале с участием несовершеннолетнего. Публичность фотографии не равна согласию, а согласие не переносится между проектами.
Быстрый старт 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-character-swap/video-edit",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"resolution": "480p",
"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.
