Wan 2.2 Animate API

Wan 2.2 Animate trasforma un’immagine di personaggio approvata e un riferimento di movimento separato in una nuova clip in cui quel personaggio recita. Usalo quando aspetto e movimento sono già stati decisi in materiali diversi, invece di chiedere entrambi a un’unica sorgente.

Funziona in due modalità. Con animation_mode su animate, il personaggio della tua immagine si muove con il movimento del video guida; con replace, la persona nel video guida viene sostituita da quella della tua immagine e la scena del video resta. L’output dura quanto il video guida, da 2 a 30 secondi, a 480p o 720p.

Una posa ad A pulita vale più di un prompt lungo

L’immagine di riferimento pubblicata è esattamente il tipo di immagine che serve a questo endpoint: corpo intero in inquadratura, posa neutra ad A, fondale continuo, luce uniforme. Tutto l’aspetto dell’output viene da quell’immagine. Un’immagine tagliata o molto coperta limita ogni clip che ne ricaverai, e nessun prompt lo recupera.

La clip dura quanto la sorgente, fino a 30 secondi

L’output dura quanto il video guida, che deve durare da 2 a 30 secondi, quindi una sorgente di due minuti va prima tagliata. Il costo segue i secondi effettivamente consegnati e non il tetto usato per il preventivo, perciò tagliare il video guida prima del caricamento è il modo diretto per controllare la spesa.

Verifica la somiglianza a 480p prima di pagare i 720p

La clip pubblicata è la stessa immagine guidata da un video di riferimento: stesso top bordeaux, stessi pantaloni a gamba larga, ora a metà di una rotazione. La risoluzione è una fascia di prezzo e 720p costa di più al secondo di 480p, quindi verifica prima a 480p, sul video guida più breve utilizzabile, che identità e silhouette reggano.

Inserisci il tuo personaggio in un girato esistente

Con animation_mode su replace, la persona nel video guida viene sostituita dal personaggio della tua immagine, mentre il girato conserva la propria scena. Usalo quando la location esiste già su video e deve cambiare solo chi recita.

Loop brevi da un solo foglio personaggio

Fino a 30 secondi bastano per un loop da feed, uno sticker o una clip di reazione. Tieni un’unica immagine e cambia i video guida per creare una libreria di gesti, come un saluto, una rotazione o un’alzata di spalle, che si leggono tutti come lo stesso personaggio perché condividono la stessa immagine di riferimento.

Coreografie e numeri di performance

Un’immagine del personaggio più un video guida della sequenza che vuoi: abiti e corporatura li fissa l’immagine, mentre tempi, peso e camera vengono dal girato. Il limite è la proprietà: ti servono i diritti sia sull’immagine sia sul video guida, e sei responsabile dell’uso del risultato.

Prova un’immagine prima di un rendering più lungo

Esegui un trasferimento di cinque secondi a 480p per vedere se una nuova immagine del personaggio tiene volto, mani e silhouette in movimento. È il modo più economico per scartare un’immagine sbagliata prima di usarla in un lavoro completo da 30 secondi.

# 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": "alibaba/wan-2.2-animate/character-animation",
  "input": {
    "animation_mode": "animate",
    "image_url": "https://example.com/reference.png",
    "resolution": "720p",
    "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.