Einführung
MiniMax H3 Character Swap Video-Bearbeitung besetzt eine Person in einem kurzen Clip mit der Figur aus einem einzigen Bild neu.
Wichtige Funktionen und Highlights
- Sende deinen Clip, das Figurenbild und die Person, die ersetzt werden soll; die Plattform erstellt die Anweisung, auf die der Adapter trainiert wurde („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”).
- Der Character-Swap-V1.5-Adapter wird mit Stärke 1 geladen.
- Mit dem Adapter folgte der Tausch der Vorlage Schlag für Schlag; dasselbe Basismodell ohne Adapter verlor die Darbietung auf halbem Weg und ließ einmal den ursprünglichen Mann als Passanten im Bild stehen.
- In einer Einstellung mit zwei Personen änderte sich nur die genannte Person.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
video_url | Ja | Der Quellclip (MP4). Bis zu 15 Sekunden werden genutzt; eine durchgehende Einstellung ohne Schnitt funktioniert am besten. mindestens 1 Zeichen |
image_url | Ja | Ein Bild der neuen Figur: ein Foto, ein 3D-Render oder eine Zeichnung. Ganzkörper auf neutralem Hintergrund ergibt die beste Übereinstimmung bei Gesicht, Haar und Outfit. mindestens 1 Zeichen |
prompt | Nein | Wen Sie ersetzen sollen, in wenigen Worten, etwa „die Frau links“ oder „der Mann im weißen Hemd“. Leer lassen, um die Hauptperson zu ersetzen. höchstens 300 Zeichen |
aspect_ratio | Nein | Form der Ausgabe (Standard 16:9). Wählen Sie dieselbe Form wie Ihr Quellclip. |
resolution | Nein | 480p (Standard), 540p, 768p oder 1080p. Höhere Stufen kosten mehr pro Sekunde; mit 480p prüfen Sie einen Tausch günstig zuerst. |
duration_seconds | Nein | Ausgabelänge von 3 bis 15 Sekunden (Standard 5). Stellen Sie sie auf die Länge Ihres Clips ein, damit die ganze Darbietung genutzt wird. |
seed | Nein | Hält Läufe vergleichbar, während Sie jeweils eine Eingabe ändern. Es verspricht keinen bildgleichen Clip. |
Preis
Abgerechnet pro Sekunde Ausgabe plus pro Sekunde Quellvideo (jede begonnene Sekunde zählt, bis 15), zuzüglich einer kleinen Gebühr für das Figurenbild; der Satz hängt von der Auflösung ab.
| Spezifikation | Preis |
|---|---|
| $0.06 / Sekunde |
| $0.09 / Sekunde |
| $0.12 / Sekunde |
| $0.24 / Sekunde |
Anwendungsfälle
- Eine darstellende Person mit unterzeichneter Freigabe für dieselbe Aufnahme mit einem anderen Look neu besetzen.
- Eine synthetische Figur, die Sie erzeugt haben, in Realaufnahmen einsetzen, die Sie gedreht haben.
- Schnelle Vorschauen von Kostüm- oder Besetzungsideen vor einem Nachdreh.
Prompt-Leitfaden und Praxistipps
- Gezeichnete und 3D-animierte Referenzen kommen als echte Menschen mit demselben Haar, denselben Farben und demselben Outfit heraus.
- Manche Läufe behalten das Quell-Outfit, weichen vom Referenzgesicht ab oder fügen Statisten im Hintergrund hinzu; mit einem anderen Seed oder einem anderen Clip erneut laufen lassen.
- Verwenden Sie es nur mit Material und Ähnlichkeiten, die Sie verarbeiten dürfen: sich selbst, eine darstellende Person mit unterzeichneter Freigabe oder eine synthetische Person, die Sie erzeugt haben. Verwenden Sie es nicht, um eine echte Person in intime oder diffamierende Aufnahmen zu setzen, ohne deren ausdrückliche, informierte Einwilligung, nicht um sich als jemand anderes auszugeben und nicht bei Material mit Minderjährigen. Dass ein Foto öffentlich ist, ist keine Einwilligung, und eine Einwilligung gilt nicht von einem Projekt auf das nächste.
API-Schnellstart
# 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"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
