Introduzione
MiniMax H3 Character Swap Video edit ricasta una persona in una clip breve con il personaggio di una singola immagine.
Caratteristiche principali
- Invia la clip, l'immagine del personaggio e chi sostituire; la piattaforma costruisce l'istruzione su cui è stato addestrato l'adattatore («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»).
- L'adattatore Character Swap V1.5 si carica con forza 1.
- Con l'adattatore lo scambio seguiva l'originale battuta per battuta; lo stesso modello base senza di lui perdeva la recitazione a metà e una volta lasciava l'uomo originale nell'inquadratura come passante.
- In un'inquadratura con due persone cambiava solo la persona indicata.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
video_url | Sì | La clip sorgente (MP4). Vengono usati fino a 15 secondi; funziona meglio un’inquadratura continua senza tagli. almeno 1 caratteri |
image_url | Sì | Un’immagine del nuovo personaggio: una foto, un render 3D o un disegno. A figura intera su sfondo neutro dà la migliore corrispondenza di volto, capelli e outfit. almeno 1 caratteri |
prompt | No | Chi sostituire, in poche parole, come “la donna a sinistra” o “l’uomo con la camicia bianca”. Lascialo vuoto per sostituire la persona principale. al massimo 300 caratteri |
aspect_ratio | No | Formato dell’output (predefinito 16:9). Scegli lo stesso formato della tua clip sorgente. |
resolution | No | 480p (predefinito), 540p, 768p o 1080p. Le risoluzioni più alte costano di più al secondo; 480p è il modo economico per verificare prima uno scambio. |
duration_seconds | No | Durata dell’output da 3 a 15 secondi (predefinito 5). Impostala sulla lunghezza della tua clip così da usare tutta la performance. |
seed | No | Mantiene comparabili le esecuzioni mentre cambi un input alla volta. Non garantisce una clip identica fotogramma per fotogramma. |
Prezzi
Addebitato per secondo di output più per secondo di video sorgente (ogni secondo iniziato conta, fino a 15), più una piccola tariffa per l’immagine del personaggio; la tariffa dipende dalla risoluzione.
| Specifiche | Prezzo |
|---|---|
| $0.06 / secondo |
| $0.09 / secondo |
| $0.12 / secondo |
| $0.24 / secondo |
Casi d’uso
- Ricastare un interprete con liberatoria firmata con un aspetto diverso per la stessa ripresa.
- Inserire un personaggio sintetico che hai generato in un filmato dal vivo che hai girato.
- Anteprime rapide di idee di costumi o di casting prima di rigirare.
Consigli avanzati
- I riferimenti disegnati e in 3D escono come persone reali con gli stessi capelli, colori e outfit.
- Alcune esecuzioni mantengono l’abito della sorgente, si allontanano dal volto di riferimento o aggiungono comparse sullo sfondo; rilancia con un altro seed o un’altra clip.
- Usalo solo su filmati e somiglianze che sei autorizzato a elaborare: te stesso, un interprete con liberatoria firmata o una persona sintetica che hai generato. Non usarlo per inserire una persona reale in filmati intimi o diffamatori senza il suo consenso informato e inequivocabile, per impersonare qualcuno, né su filmati che ritraggono un minore. Il fatto che una fotografia sia pubblica non equivale a consenso, e il consenso non è trasferibile tra progetti.
Avvio rapido dell’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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.















