Video Character Swap API

Video Character Swap reçoit l’identifiant de tâche d’une analyse, les positions retenues parmi ses vignettes et une à trois photos de référence pour chacune, puis renvoie le plan avec ces personnes remplacées. La silhouette entière change, vêtements et morphologie compris ; le décor, le mouvement de caméra, la chorégraphie et la bande son d’origine restent tels qu’ils ont été tournés. Les personnes non listées ne sont pas touchées.

Video Character Swap tient en deux appels. Le premier suit chaque personne dans un plan de 5 à 30 secondes et renvoie une vignette par personne, dans un ordre fixe. Le second reçoit les positions retenues et une à trois photos de référence pour chacune, puis renvoie le plan avec ces personnes remplacées et la bande son d’origine intacte.

Analyse vidéo Character Swap → Édition vidéo Character Swap

C’est vous qui désignez la personne

La plupart des endpoints de ce type doivent deviner qui vous vouliez dire. Ici, le premier appel vous montre chaque personne trouvée, numérotée, et le second ne touche qu’aux numéros que vous renvoyez. Dans une scène à quatre personnes, vous en remplacez une et les trois autres restent exactement telles qu’elles ont été tournées.

Donnez au modèle de quoi travailler sous le cou

Video Character Swap n’est pas un endpoint mais une paire. Le premier appel, video-analyze, suit toutes les personnes d’un plan de 5 à 30 secondes et renvoie une vignette par personne dans un ordre fixe, facturée au forfait par requête quelles que soient la durée du plan et le nombre de personnes trouvées. Le second appel, video-edit, reçoit l’identifiant de tâche de cette analyse, les positions retenues et une à trois photos de référence pour chacune, puis renvoie un plan unique dont la bande son d’origine est conservée, facturé à la seconde de métrage en 480p ou 720p. Là où la paire head swap ne change que la tête, celle-ci remplace la silhouette entière, vêtements et morphologie compris, tandis que le décor, le mouvement de caméra et la chorégraphie restent tels qu’ils ont été tournés. Les données de suivi elles-mêmes ne vous sont jamais exposées : vous travaillez avec votre propre identifiant de tâche et des positions numérotées à partir de zéro.

Changer de rôle sans retourner le plan

Le décor, le mouvement de caméra et la chorégraphie sont déjà justes. Plutôt que de régénérer tout le plan et de reprendre le travail d’image à zéro, vous remplacez la silhouette qui les interprète.

Tout sujet, avec un interprète consentant

Rien ne change dans la requête, quel que soit le contenu des images. L’exigence d’autorisation décrite plus bas ne change pas non plus : c’est une condition ferme, pas une formalité.

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

Générez une série de plans avec n’importe quel modèle vidéo, analysez chacun d’eux, puis faites passer le même personnage dans tous, pour que la série se lise comme un seul interprète.

Une foule dont une seule personne change

Analysez une scène à plusieurs personnes, regardez les vignettes et ne renvoyez que la position visée. Toutes les autres restent intactes.

# 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/character-swap-v1/video-edit",
  "input": {
    "analysis_task_id": "example",
    "resolution": "720p",
    "swap_targets": [
      {
        "image_urls": [
          "example"
        ],
        "object_index": 0
      }
    ]
  }
}'

# 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.