Video Face Swap API

Video Face Swap porta i tratti del volto di una singola immagine di riferimento sulla persona presente in un video, attraverso ogni fotogramma della clip. Viaggiano solo i tratti: pettinatura, silhouette della testa, movimento, abiti, luce, lavoro di camera e sfondo dell'interprete restano come sono stati girati, ed è questo a far leggere il risultato come il girato originale invece che come una sovrapposizione.

Video Face Swap prende una clip video e un'immagine di volto di riferimento e porta soltanto i tratti del viso sulla persona nel girato, conservandone capelli, movimento, inquadratura e sfondo. Due URL e una finitura facoltativa: non c'è nessun campo prompt da scrivere.

Conserva la performance, cambia l’identità del volto

Face Swap applica alla persona nel filmato l’identità della referenza approvata, mantenendo intatta la performance dal vivo. Scegli un clip in cui soggetto, inquadratura e luce siano già corretti: questo flusso sostituisce un’identità, non ricostruisce una scena.

Valuta la continuità, non una scena sintetica

Esamina il risultato a velocità normale attraverso rotazioni, tagli e movimenti rapidi. Verifica che il trasferimento resti coerente e che capelli, movimento, abiti e sfondo continuino a leggere come il filmato originale.

Modifica una clip fornita

Video Face Swap porta i tratti del volto di una singola immagine di riferimento sulla persona presente in un video, attraverso ogni fotogramma della clip. Viaggiano solo i tratti: pettinatura, silhouette della testa, movimento, abiti, luce, lavoro di camera e sfondo dell'interprete restano come sono stati girati, ed è questo a far leggere il risultato come il girato originale invece che come una sovrapposizione. Usa questa modalità quando il video sorgente deve restare il punto di partenza di un montaggio. Descrivi con precisione la modifica e verifica continuità, ritmo e dettagli da preservare.

Un volto attraverso una serie generata

Genera una serie di clip con un modello video qualsiasi, poi porta un volto consenziente su tutte quante, così la serie si legge come la stessa persona. Movimento, abiti e scenografia restano quelli di ogni clip, quindi la varietà che hai generato sopravvive alla passata.

Contenuti senza censura con il volto di un interprete consenziente

Sposta un volto che sei autorizzato a usare su girato prodotto da te. Per il materiale senza censura non cambia nulla nella richiesta, ma l'obbligo di autorizzazione descritto qui sotto è vincolante, non una formalità.

Ricambiare l'interprete in una ripresa già buona

Tieni una ripresa la cui luce, messa in scena e movimento di camera sono già stati approvati e mettici un volto diverso, invece di rigenerare l'intera inquadratura e perdere la recitazione che avevi.

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

Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.