Introduction
MiniMax H3 Character Swap Video edit remplace une personne dans un court clip par le personnage d’une seule image.
Fonctionnalités et points forts
- Envoyez votre clip, l'image du personnage et la personne à remplacer ; la plateforme construit la consigne sur laquelle l'adaptateur a été entraîné (« 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'adaptateur Character Swap V1.5 se charge à une force de 1.
- Avec l'adaptateur, le remplacement suivait la source temps par temps ; le même modèle de base sans lui perdait la performance à mi-parcours et laissait une fois l'homme d'origine dans le plan, en passant.
- Dans un plan à deux personnes, seule la personne désignée a changé.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
video_url | Oui | Le clip source (MP4). Jusqu’à 15 secondes sont utilisées ; un plan continu sans coupure donne les meilleurs résultats. 1 caractères minimum |
image_url | Oui | Une image du nouveau personnage : photo, rendu 3D ou dessin. Une photo en pied sur fond uni donne la meilleure correspondance de visage, de cheveux et de tenue. 1 caractères minimum |
prompt | Non | Qui remplacer, en quelques mots, par exemple "the woman on the left" ou "the man in the white shirt". Laissez vide pour remplacer la personne principale. 300 caractères maximum |
aspect_ratio | Non | Format de la sortie (16:9 par défaut). Choisissez le même format que votre clip source. |
resolution | Non | 480p (par défaut), 540p, 768p ou 1080p. Les paliers supérieurs coûtent davantage par seconde ; le 480p est le moyen économique de vérifier un changement avant tout. |
duration_seconds | Non | Durée de sortie de 3 à 15 secondes (5 par défaut). Réglez-la sur la longueur de votre clip pour utiliser toute l’interprétation. |
seed | Non | Permet de garder les essais comparables lorsque vous modifiez une seule entrée à la fois. Cela ne garantit pas un clip identique image par image. |
Tarification
Facturé à la seconde de sortie, plus à la seconde de vidéo source (chaque seconde entamée compte, jusqu’à 15), plus des frais réduits pour l’image du personnage ; le tarif dépend de la résolution.
| Spécification | Prix |
|---|---|
| $0.06 / seconde |
| $0.09 / seconde |
| $0.12 / seconde |
| $0.24 / seconde |
Cas d’utilisation
- Redistribuer un interprète ayant signé une autorisation avec un autre look pour la même prise.
- Placer un personnage synthétique que vous avez généré dans des images en prise de vue réelle que vous avez tournées.
- Aperçus rapides d’idées de costumes ou de casting avant un nouveau tournage.
Guide de prompt et conseils pratiques
- Les références dessinées et animées en 3D deviennent des personnes en prise de vue réelle avec les mêmes cheveux, couleurs et tenue.
- Certaines générations gardent la tenue source, dérivent du visage de référence ou ajoutent des figurants en arrière-plan ; relancez avec un autre seed ou un autre clip.
- Utilisez-le uniquement sur des images et des ressemblances que vous êtes autorisé à traiter : vous-même, un interprète ayant signé une autorisation, ou une personne synthétique que vous avez générée. Ne l’utilisez pas pour placer une personne réelle dans des images intimes ou à caractère diffamatoire sans son consentement exprès et éclairé, pour usurper l’identité de quiconque, ni sur des images de mineurs. Qu’une photo soit publique ne vaut pas consentement, et le consentement n’est pas transférable d’un projet à un autre.
Démarrage rapide de l’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"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
