Wan 2.2 Animate: preparare un personaggio e un riferimento di movimento

Wan 2.2 Animate richiede un'immagine del personaggio e un video di guida. L'immagine fornisce l'aspetto; il video fornisce il movimento del corpo, l'espressione del viso e la durata. Scegli animate perché il personaggio raffigurato esegua il movimento nell'ambiente proprio dell'immagine, oppure replace per collocare quel personaggio nella scena del video di guida. Per un primo tentativo, usa un adulto completamente visibile, un gesto di sei secondi e nessun taglio.

Apri Wan 2.2 Animate animazione dei personaggi. Con i prezzi indicati al 3 ottobre 2026, sei secondi costano $0.318 a 480p o $0.66 a 720p. Nessuna delle due modalità inventa una nuova location dal prompt: lo sfondo proviene sempre da uno dei tuoi due file.

Scegli la modalità prima di registrare

Per esempio, una donna adulta illustrata con giacca color prugna e pantaloni avorio può eseguire un passo laterale di benvenuto. Se la sala di prova non è rilevante, usa animate con un'immagine del personaggio su sfondo neutro. Se la sua finestra ad arco e il pavimento in legno devono restare nell'inquadratura, usa replace ed esamina come il nuovo corpo incontra quel pavimento. Un video di guida con più persone non dà a replace alcun modo di scegliere chi viene sostituito; usa una sola performer, oppure consulta l'ultima sezione.

Il progetto ufficiale Wan-Animate descrive entrambe le attività, incluso il modo in cui la sostituzione si adatta all'illuminazione e ai colori della scena. La sua guida di pre-elaborazione avverte che una forte discrepanza di proporzioni corporee tra personaggio e performer provoca artefatti nella sostituzione.

Prepara un'immagine del personaggio che mostri le parti che si muovono

Usa un'immagine a figura intera, scarpe comprese, in una posizione rilassata frontale con le braccia leggermente staccate dal torso e con l'abbigliamento che vuoi animare. Uno sfondo semplice e illuminato in modo uniforme mantiene pulito il risultato animate, perché quello sfondo diventa la scena. Un primo piano lascia indefinite le gambe dei pantaloni, le calzature e la forma del corpo, e una descrizione dell'abbigliamento più lunga nel prompt non fornisce quelle viste.

Il file deve essere JPEG, PNG o WebP con meno di 10 MB e deve contenere un volto o una persona riconoscibile; in caso contrario l'attività viene rifiutata con invalid_request.

Ecco un brief di immagine non esplicita di un'adulta fittizia che puoi usare in un generatore di immagini:

Riferimento di personaggio a figura intera di una donna adulta fittizia, circa 30 anni, con riccioli corti e scuri, giacca di prova color prugna, pantaloni avorio e scarpe piatte color carbone. Posizione comoda ed equilibrata, braccia rilassate leggermente staccate dal torso, entrambe le mani ed entrambe le scarpe visibili. Sfondo di studio semplice e tranquillo, volto e abbigliamento leggibili, nessuna scrittura, nessun'altra persona.

Una figura stilizzata va bene, ma arti con lunghezze molto diverse da quelle della performer rendono più difficile giudicare il contatto con il pavimento e la portata.

Illustrazione: il design del personaggio fornisce l'aspetto, il movimento della performer fornisce il movimento. Non è un output di Wan.

Registra un movimento di sei secondi con un inizio e una fine utilizzabili

Fissa la camera su un supporto stabile per il tuo primo video di guida, così che il movimento del corpo sia facile da leggere. Entrambe le modalità possono recepire il movimento di camera dal video di guida; animate mantiene l'ambiente dell'immagine del personaggio, mentre replace mantiene la scena del video. Inquadra una performer adulta in modo che entrambe le scarpe e tutta l'apertura delle braccia restino visibili. Inizia con una posizione neutra frontale simile all'immagine del personaggio, poi registra una breve pausa, un passo laterale, un gesto di apertura delle braccia poco ampio, le braccia abbassate e una pausa finale. Tieni le mani lontane dal viso ed evita che qualcuno passi davanti.

Il viso della performer conta: l'espressione viene copiata dal video insieme al movimento, quindi mantieni il viso inquadrato e abbastanza grande da poter essere letto. Il riferimento dovrebbe già avere il ritmo che desideri; il prompt non può trasformare una rotazione rapida in un saluto lento né recuperare un appoggio del piede nascosto dietro una sedia.

Ritaglia il materiale prima del caricamento. Con FFmpeg installato, questo comando parte da un secondo dentro una registrazione ed esporta un MP4 di sei secondi, ridotto a un massimo di 720 pixel di altezza mantenendo le proporzioni originali:

ffmpeg -ss 1 -i rehearsal.mov -t 6 \
  -vf "scale=-2:'min(720,ih)'" \
  -c:v libx264 -crf 18 -pix_fmt yuv420p driving-six-seconds.mp4

Evita le barre formato cinema e il padding: in replace diventano parte della scena.

La sorgente deve durare 2–30 secondi; i file più corti o più lunghi vengono rifiutati prima che venga addebitato qualsiasi importo. Carica un MP4 fino a 90 MB oppure passa un URL diretto di MP4 o MOV. Una pagina che riproduce soltanto il video non è un URL di file diretto, e l'attività fallisce con l'addebito rimborsato. La durata della sorgente determina la durata dell'output, quindi non esiste alcun campo duration_seconds per allungare una performance di due secondi a sei.

Illustrazione: l'inquadratura a figura intera lascia spazio per il passo laterale e mantiene visibile il contatto con il pavimento.

Provalo prima nel Playground

1. Apri la pagina di animazione dei personaggi e resta nella scheda Playground nella vista Form. Accedi con un account con saldo per avviare l'esecuzione.
2. Inserisci la tua immagine del personaggio in Input image e il tuo MP4 ritagliato in Input video. Entrambi accettano anche un Asset URL.
3. Imposta Animation mode su Animate the image oppure Replace in the video.
4. Imposta Resolution su 480p mentre verifichi identità e silhouette; poi renderizza di nuovo la take che tieni a 720p.
5. Incolla il prompt di supporto qui sotto e imposta un Seed come 42, così due esecuzioni sullo stesso video di guida sono confrontabili.
6. Controlla la stima del prezzo e avvia l'esecuzione.

Anima la donna adulta fittizia nell'immagine fornita usando la performance fornita. Mantieni leggibili il singolo passo laterale di benvenuto e il gesto di apertura delle braccia poco ampio, con i piedi appoggiati e un finale rilassato. Conserva la giacca color prugna, i pantaloni avorio, i riccioli corti e le scarpe piatte. Nessuna scrittura aggiunta.

Il prompt supporta il movimento registrato; chi appare proviene dall'immagine. Per la versione con sostituzione della scena, scegli Replace in the video e chiedi di mantenere la camera, l'illuminazione e il pavimento della stanza fornita invece di richiedere una nuova location.

Questa attività non ha campi per LoRA, rapporto d'aspetto o ingresso audio, quindi non prenderli in prestito da un altro endpoint Wan.

La fatturazione è per secondo consegnato: $0.053 a 480p e $0.11 a 720p, quindi una sorgente di 12 secondi costa $0.636 o $1.32. Solo la risoluzione cambia la tariffa; né la modalità, né il prompt, né il seed. Ogni attività viene prima preventivata al massimo di 30 secondi e la differenza viene rimborsata quando il saldo si regola sulla durata reale, quindi ritaglia prima i tempi di prova inutili, ma conserva i contatti che il piano finale richiede.

Poi eseguilo dal codice

Installa l'SDK Python (pip install spicyapi), imposta SPICY_API_KEY nell'ambiente del tuo server ed esegui:

import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment

image = client.upload_file("./character.png")             # local files become spicy:// URIs
video = client.upload_file("./driving-six-seconds.mp4")

task = client.create_task(
    model="alibaba/wan-2.2-animate/character-animation",
    input_data={
        "image_url": image["uri"],
        "video_url": video["uri"],
        "animation_mode": "animate",
        "resolution": "720p",
        "prompt": "Animate this fictional adult character using the supplied sidestep and open-arm "
                  "performance. Retain the plum jacket and ivory trousers. No added lettering.",
        "seed": 42,
    },
    idempotency_key=str(uuid.uuid4()),
)

final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
    raise RuntimeError(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
print(output_assets(final)[0]["url"])  # copy the clip to your own storage now

Preventivi, polling, download, retry e codici di errore sono trattati nella guida alle attività e nel riferimento dell'SDK Python.

Oppure lascia che lo esegua un Agent

Quando un assistente deve eseguire le generazioni, tutti e tre gli strumenti ufficiali mostrano il prezzo e ti chiedono prima di una chiamata a pagamento.

• CLI. Carica ogni file con spicyapi files upload ./character.png, inserisci gli indirizzi spicy:// restituiti in image_url e video_url di un input.json con i campi sopra, poi esegui spicyapi tasks create --model alibaba/wan-2.2-animate/character-animation --input-file input.json --wait. Vedi la documentazione della CLI.
• Server MCP. Aggiungi il server MCP al tuo assistente, poi chiedi: "Anima /path/to/character.png con /path/to/driving.mp4 su Wan 2.2 Animate, modalità animate, 480p". Carica entrambi i file con spicyapi_upload_file, poi chiama spicyapi_task_create, che si ferma in attesa della tua conferma del prezzo.
• Skill. npx skills add spicyapi-ai/spicy-skill installa l'Agent Skill, che fa leggere a un assistente di programmazione lo schema del modello in tempo reale invece di indovinare i campi.

Cambia l'input che spiega il problema

Per replace, confronta il pavimento, i bordi delle finestre e gli oggetti in primo piano con l'originale.

Diritti e quando un'altra attività è più adatta

Ti servono i diritti su entrambi i file e il consenso di chiunque sia ripreso o ritratto. Wan 2.2 Animate è elencato come modello senza censura: SpicyAPI non aggiunge alcun filtro dei contenuti, quindi questa responsabilità è tua.

Se deve cambiare solo il viso, Video Face Swap mantiene il resto del clip originale. Se bisogna sostituire una persona tra diverse, o l'audio originale del clip deve restare, usa Character Swap, che analizza il clip e ti lascia scegliere la persona prima di modificarlo. Se non devi copiare una performance specifica, da immagine a video è più semplice.