Wprowadzenie
MiniMax H3 Character Swap, edycja wideo przeobsadza jedną osobę w krótkim klipie postacią z pojedynczego obrazu.
Najważniejsze funkcje
- Wyślij klip, obraz postaci i osobę do zastąpienia; platforma buduje instrukcję, na której wytrenowano adapter („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”).
- Adapter Character Swap V1.5 ładuje się z siłą 1.
- Z adapterem podmiana szła za oryginalnym występem takt po takcie; sam model bazowy bez niego gubił grę w połowie i raz zostawił oryginalnego mężczyznę w kadrze jako przechodnia.
- W ujęciu z dwiema osobami zmieniała się tylko wskazana osoba.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
video_url | Tak | Źródłowy klip (MP4). Używanych jest do 15 sekund; najlepiej działa jedno ciągłe ujęcie bez cięć. od 1 znaków |
image_url | Tak | Jeden obraz nowej postaci: zdjęcie, render 3D albo rysunek. Pełna sylwetka na jednolitym tle daje najlepsze dopasowanie twarzy, włosów i stroju. od 1 znaków |
prompt | Nie | Kogo zastąpić, w kilku słowach, na przykład „kobieta po lewej” albo „mężczyzna w białej koszuli”. Zostaw puste, by zastąpić główną osobę. do 300 znaków |
aspect_ratio | Nie | Kształt wyniku (domyślnie 16:9). Wybierz ten sam kształt co w klipie źródłowym. |
resolution | Nie | 480p (domyślnie), 540p, 768p lub 1080p. Wyższe poziomy kosztują więcej za sekundę; 480p to tani sposób na sprawdzenie zamiany przed 1080p. |
duration_seconds | Nie | Długość wyniku od 3 do 15 sekund (domyślnie 5). Ustaw ją na długość klipu, by użyć całego występu. |
seed | Nie | Pozwala porównywać wyniki, gdy zmieniasz jedno wejście naraz. Nie obiecuje klipu identycznego co do klatki. |
Cennik
Rozliczane za sekundę wyniku oraz za sekundę wideo źródłowego (liczy się każda zaczęta sekunda, do 15), a także niewielka opłata za obraz postaci; stawka zależy od rozdzielczości.
| Specyfikacja | Cena |
|---|---|
| $0.06 / sekundę |
| $0.09 / sekundę |
| $0.12 / sekundę |
| $0.24 / sekundę |
Zastosowania
- Przeobsadzenie aktora z podpisaną zgodą w innym wyglądzie w tym samym ujęciu.
- Umieszczenie wygenerowanej przez ciebie postaci syntetycznej w nagraniu z prawdziwego planu, które sam nakręciłeś.
- Szybkie podglądy pomysłów na kostiumy lub obsadę przed dokrętkami.
Wskazówki
- Postacie narysowane i animowane 3D wychodzą jako ludzie z prawdziwego świata z tymi samymi włosami, kolorami i strojem.
- Niektóre przebiegi zachowują strój ze źródła, odchodzą od twarzy z referencji albo dodają statystów w tle; uruchom ponownie z innym seedem lub innym klipem.
- Używaj tylko materiałów i wizerunków, do których masz prawo: siebie, aktora z podpisaną zgodą albo wygenerowaną osobę syntetyczną. Nie używaj tego, by umieścić prawdziwą osobę w materiałach intymnych lub kompromitujących bez jej wyraźnej, świadomej zgody, by się pod kogokolwiek podszywać ani na jakichkolwiek materiałach z udziałem małoletniego. To, że zdjęcie jest publiczne, nie jest zgodą, a zgoda nie przenosi się między projektami.
Szybki start z 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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
