Video Face Swap API

Video Face Swap transpose les traits du visage d'une seule image de référence sur la personne filmée, sur toutes les images du clip. Seuls les traits voyagent : la coiffure, la silhouette de la tête, les mouvements, la tenue, l'éclairage, les mouvements de caméra et le décor restent tels qu'ils ont été tournés, ce qui permet au résultat de passer pour la séquence d'origine plutôt que pour un calque posé dessus.

Video Face Swap reçoit un clip vidéo et une image de visage de référence, puis transpose uniquement les traits sur la personne filmée, en conservant ses cheveux, ses mouvements, le cadrage et le décor. Deux URL et un rendu facultatif : il n'y a aucun champ de prompt à rédiger.

Préserver la performance, changer l’identité faciale

Face Swap applique l’identité de la référence validée à la personne du plan fourni tout en préservant la performance filmée. Choisissez un clip dont le sujet, le cadrage et la lumière fonctionnent déjà : ce flux remplace une identité, il ne reconstruit pas un plan.

Vérifier la continuité, pas une scène synthétique

Évaluez le résultat à vitesse normale sur les rotations, les coupes et les mouvements rapides. Vérifiez que le transfert reste cohérent et que les cheveux, le mouvement, la tenue et l’arrière-plan restent ceux du plan d’origine.

Modifier un clip fourni

Video Face Swap transpose les traits du visage d'une seule image de référence sur la personne filmée, sur toutes les images du clip. Seuls les traits voyagent : la coiffure, la silhouette de la tête, les mouvements, la tenue, l'éclairage, les mouvements de caméra et le décor restent tels qu'ils ont été tournés, ce qui permet au résultat de passer pour la séquence d'origine plutôt que pour un calque posé dessus. Utilisez ce mode lorsqu’une vidéo source doit rester le point de départ d’un montage. Décrivez précisément la modification et vérifiez continuité, rythme et détails à conserver.

Un même visage sur toute une série générée

Générez une série de clips avec n'importe quel modèle vidéo, puis transposez sur chacun un même visage autorisé pour que la série montre la même personne. Mouvements, tenues et décors restent propres à chaque clip, si bien que la variété obtenue à la génération survit au passage.

Contenu sans censure avec l'image d'un interprète consentant

Transposez un visage que vous êtes autorisé à utiliser sur des séquences que vous avez produites. Rien ne change dans la requête pour un contenu sans censure, mais l'exigence d'autorisation décrite dans les limites ci-dessous est une condition ferme, pas une formalité.

Changer l'interprète d'une prise déjà réussie

Gardez une prise dont l'éclairage, la mise en place et le mouvement de caméra sont déjà validés, et placez-y un autre visage au lieu de régénérer tout le plan et de perdre la performance obtenue.

# 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": "spicyapi/face-swap-video-v1/video-edit",
  "input": {
    "reference_image_url": "https://example.com/reference.png",
    "style": "realistic",
    "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.