Video Character Swap API

Video Character Swap riceve l'id del task di un'analisi, le posizioni scelte fra le sue anteprime e da una a tre foto di riferimento per ciascuna, e restituisce la clip con quelle persone sostituite. La figura cambia per intero, abiti e corporatura compresi; scenografia, movimento di macchina, coreografia e traccia audio originale restano come sono stati girati. Le persone che non elenchi non vengono toccate.

Video Character Swap si svolge in due chiamate. La prima traccia ogni persona in una clip da 5 a 30 secondi e restituisce un fermo immagine di anteprima per persona, in ordine fisso. La seconda riceve le posizioni che hai scelto e da una a tre foto di riferimento per ciascuna, e restituisce la clip con quelle persone sostituite e l'audio originale intatto.

Analisi video Character Swap → Modifica video Character Swap

Chi cambia lo decidi tu

La maggior parte degli endpoint di questo tipo deve indovinare a quale persona ti riferivi. Qui la prima chiamata ti mostra ogni persona trovata, numerata, e la seconda tocca solo i numeri che rimandi indietro. In una scena con quattro persone ne sostituisci una e le altre tre restano esattamente come sono state girate.

Dai al modello qualcosa sotto il collo

Video Character Swap non è un endpoint ma una coppia. La prima chiamata, video-analyze, traccia tutte le persone di una clip da 5 a 30 secondi e restituisce un'anteprima per persona in ordine fisso, a tariffa fissa per richiesta, qualunque sia la durata della clip e quante persone trovi. La seconda chiamata, video-edit, riceve l'id del task di quell'analisi, le posizioni che hai scelto e da una a tre foto di riferimento per ciascuna, e restituisce una sola clip con la traccia audio originale intatta, addebitata al secondo di girato in 480p o 720p. Dove la coppia head swap cambia solo la testa, questa sostituisce la figura intera, abiti e corporatura compresi, mentre scenografia, movimento di macchina e coreografia restano come sono stati girati. I dati di tracciamento non arrivano mai fino a te: lavori con il tuo id del task e con posizioni numerate da zero.

Cambiare interprete senza rigirare

Scenografia, movimento di macchina e coreografia sono già come volevi. Invece di rigenerare tutta l'inquadratura e rifare il lavoro sull'immagine, sostituisci solo la figura che la interpreta.

Qualsiasi soggetto, con un interprete consenziente

Qualunque cosa mostri il materiale, nella richiesta non cambia nulla. Nemmeno il requisito di autorizzazione descritto più sotto cambia: è una condizione rigida, non una formalità.

Uno stesso personaggio in tutta una serie generata

Genera un lotto di clip con qualsiasi modello video, analizza ciascuna e porta lo stesso personaggio attraverso tutte, così che la serie si legga come un solo interprete.

Folle in cui cambia una persona sola

Analizza una scena con più persone in quadro, guarda le anteprime e rimanda indietro solo la posizione che intendevi. Tutte le altre restano intatte.

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

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