O que a API Wan 2.2 Animate faz?

A API Wan 2.2 Animate transforma uma imagem de personagem e um vídeo guia em um novo clipe no qual esse personagem executa o movimento do vídeo. Ela tem um endpoint, character-animation, com dois modos: animate mantém o próprio fundo da imagem, e replace coloca o personagem no cenário do vídeo guia. A saída acompanha a duração do vídeo guia, de 2 a 30 segundos, em 480p ou 720p.

Qual é a diferença entre o modo animate e o modo replace no Wan 2.2 Animate?

No Wan 2.2 Animate, o modo animate move o personagem de image_url com o movimento do vídeo guia e mantém o próprio fundo da imagem. O modo replace troca a pessoa em video_url por esse personagem e mantém o cenário do vídeo. animation_mode é animate por padrão, então escolha replace quando a locação da filmagem importa e animate quando o ambiente próprio do personagem importa.

O que faz um bom vídeo guia para o Wan 2.2 Animate?

Um bom vídeo guia para o Wan 2.2 Animate dura de 2 a 30 segundos e mantém o corpo e o rosto do performer visíveis durante toda a sua duração. O artigo Wan-Animate da Alibaba diz que o movimento corporal é reproduzido a partir de sinais de esqueleto e as expressões a partir de características faciais, então membros cortados ou um rosto virado deixam o modelo com menos informação para trabalhar. Corte o clipe para o movimento desejado, já que a duração dele se torna a duração da saída.

Como o Wan 2.2 Animate trata a iluminação da cena no modo replace?

O Wan 2.2 Animate não expõe nenhum controle de iluminação, então a mistura fica a cargo do modelo. O artigo Wan-Animate da Alibaba descreve a substituição como a aplicação da iluminação e do tom de cor da cena ao personagem inserido, com um LoRA auxiliar de reiluminação que mantém a aparência do personagem consistente. Como não há nada para ajustar por requisição, avalie a mistura com um teste curto em 480p antes de encomendar uma renderização mais longa.

Quanto custa a API Wan 2.2 Animate?

A API Wan 2.2 Animate é cobrada por segundo de vídeo entregue, e a resolução é o único campo que define a tarifa, com 480p e 720p como os dois níveis. Os preços atuais por segundo são exibidos ao vivo nesta página. Cada tarefa é primeiro orçada no máximo de 30 segundos, e a diferença é reembolsada quando liquidada de acordo com a duração real da saída.

O que acontece se a imagem de personagem do Wan 2.2 Animate não tiver um rosto ou pessoa claros?

O Wan 2.2 Animate rejeita a tarefa com invalid_request quando nenhum rosto ou pessoa é encontrado em image_url. A solução é usar outra imagem de personagem, uma em que a pessoa apareça por inteiro sem nada cortando ou cobrindo o corpo. Mudar o prompt ou o vídeo guia não ajuda, porque a verificação se aplica apenas à imagem do personagem.

O Wan 2.2 Animate suporta seed?

Sim, o Wan 2.2 Animate aceita um seed de 0 a 2.147.483.647, e 0 solicita um seed aleatório. Um valor fixo ajuda ao comparar tomadas no mesmo vídeo guia: mantenha o seed e mude apenas outra entrada, como prompt ou animation_mode, depois observe os dois resultados lado a lado. Use 0 sempre que quiser um novo seed aleatório a cada execução.

Quais formatos de arquivo o Wan 2.2 Animate aceita?

O Wan 2.2 Animate aceita a imagem do personagem como upload JPEG, PNG ou WebP. O vídeo guia pode ser um upload MP4 de até 90MB ou uma URL apontando para um arquivo MP4 ou MOV. Esse vídeo guia precisa durar entre 2 e 30 segundos, e sua duração define quanto tempo o clipe gerado terá.

Como o Wan 2.2 Animate se diferencia do Wan 2.2 image-to-video?

O Wan 2.2 Animate tira seu movimento de um vídeo guia, enquanto o Wan 2.2 image-to-video parte de um único quadro inicial e de um prompt de texto obrigatório de até 5.000 caracteres que descreve o que acontece. A saída do Wan 2.2 Animate segue a duração do vídeo guia, de 2 a 30 segundos, e é cobrada por segundo; o Wan 2.2 image-to-video é cobrado por requisição. Ambos oferecem 480p e 720p.

Posso usar o Wan 2.2 Animate com fotos ou filmagens de pessoas reais?

O Wan 2.2 Animate pode colocar a pessoa de uma foto dentro de uma filmagem real, então direitos e consentimento se aplicam aos dois arquivos. Use imagens e vídeos que você possui ou tem permissão para usar, mostre apenas adultos, e não use o resultado para se passar por alguém ou criar imagens íntimas de uma pessoa sem o consentimento dela. A plataforma não revisa cada requisição individualmente, o modelo aplica seus próprios limites, e o titular da conta é responsável pelo resultado.

API do Wan 2.2 Animate: movimento transferido

alibaba/wan-2.2-animate/character-animation

O Wan 2.2 Animate da Alibaba é um endpoint de animação de personagem: o movimento de um vídeo-guia é aplicado à pessoa de uma imagem. O vídeo deve ter de 2 a 30 segundos, a saída tem a mesma duração, em 480p ou 720p.

A partir de $0.053/s

Executar modelo Ver API

Entrada

Animação de personagem

Prompt0/2000

Modo de animação

Animar a imagemSubstituir no vídeo

Imagem de entrada1/1

Arraste arquivos ou links de mídia, cole ou selecione · 1 arquivo · Máx. 10 MB · JPG · PNG · WEBP

Vídeo de entrada1/1

Solte um vídeo aqui ou procure no computador · 1 arquivo · Máx. 90 MB · MP4

Resoluçãoafeta o preço

Seed

Filtro de segurançaDesligado

A SpicyAPI não executa filtro de segurança neste modelo. Seu prompt e suas mídias chegam ao modelo exatamente como você os enviou, e o próprio modelo decide o resultado.

Verificando sua conta antes de liberar o envio e a estimativa de preço.

Saída

Pronto para uma nova execução

Resultado de exemplo

Estender

Ampliação de vídeo

Edição de vídeo

{
  "model": "alibaba/wan-2.2-animate/character-animation",
  "input": {
    "animation_mode": "animate",
    "resolution": "480p",
    "image_url": "https://cdn.spicyapi.ai/models/examples/inputs/f404aa8717ae6a4f.webp",
    "video_url": "https://cdn.spicyapi.ai/models/examples/inputs/96d541c6c1ffdf0e.mp4"
  }
}

Introdução

O Wan 2.2 Animate transforma uma imagem de personagem aprovada e uma referência de movimento separada num clipe novo em que esse personagem atua. Use quando aparência e movimento já foram definidos em materiais diferentes, em vez de pedir as duas coisas a uma única fonte.

Ele funciona em dois modos. Com animation_mode em animate, o personagem da sua imagem se move com o movimento do vídeo guia; com replace, a pessoa do vídeo guia é trocada pela da sua imagem e a cena do vídeo é mantida. A saída dura o mesmo que o vídeo guia, de 2 a 30 segundos, em 480p ou 720p.

Recursos e destaques

Uma pose em A limpa vale mais que um prompt longo

A imagem de referência publicada é exatamente o tipo de imagem que este endpoint quer: corpo inteiro no quadro, pose neutra em A, fundo infinito, luz uniforme. Toda a aparência do resultado vem dessa imagem. Uma imagem cortada ou muito encoberta limita todos os clipes que você fizer com ela, e nenhum prompt recupera isso.

O clipe dura o mesmo que a fonte, até 30 segundos

A saída dura o mesmo que o vídeo guia, que precisa ter de 2 a 30 segundos, então uma fonte de dois minutos precisa ser cortada antes. A cobrança segue os segundos realmente entregues, não o teto usado no orçamento, por isso cortar o vídeo guia antes de enviar é o jeito direto de controlar o custo.

Confira a semelhança em 480p antes de pagar por 720p

O clipe publicado é a mesma imagem guiada por um vídeo de referência: o mesmo top cor de vinho, a mesma calça pantalona, agora no meio de um giro. A resolução é uma faixa de preço e 720p custa mais por segundo que 480p, então confirme primeiro em 480p, com o vídeo guia mais curto que sirva, que a identidade e a silhueta se mantêm.

Parâmetros da requisição

Parâmetros da requisição de Wan 2.2 Animate · Character Animation
Parâmetro	Obrigatório	Descrição
`animation_mode`	Não	Animate move o personagem da sua imagem com o movimento do vídeo-guia. Replace troca a pessoa do vídeo-guia pela da sua imagem e mantém a cena daquele vídeo. `animate` · `replace` · Valor padrão: `animate`
`image_url`	Sim	A imagem de personagem. É a pessoa daqui que é animada, então use uma chapa de corpo inteiro com silhueta clara e luz uniforme. pelo menos 1 caracteres
`video_url`	Sim	O vídeo-guia, de 2 a 30 segundos: envie um MP4 ou passe a URL de um MP4 ou MOV. pelo menos 1 caracteres
`resolution`	Não	480p ou 720p, padrão 720p, e uma faixa de preço. Prove a transferência em 480p e depois renderize de novo os takes que pretende entregar. `480p` · `720p` · Valor padrão: `720p`
`prompt`	Não	Opcional, até 2000 caracteres. Ele orienta estilo e conteúdo da animação — não a identidade, que pertence à imagem de personagem. no máximo 2000 caracteres
`seed`	Não	De 0 a 2147483647; zero pede um seed aleatório. Fixe-o para comparar duas execuções sobre o mesmo vídeo-guia. `≥ 0` · `≤ 2147483647`

Preços

A duração do resultado acompanha o vídeo guia e é cobrada por segundo.

Preços
Especificação	Preço
`480p`	$0.053 / segundo
`720p`	$0.11 / segundo

Casos de uso

Coloque seu personagem num material existente

Com animation_mode em replace, a pessoa do vídeo guia é trocada pelo personagem da sua imagem, enquanto o material mantém a própria cena. Use quando a locação já existe em vídeo e só quem atua precisa mudar.

Loops curtos a partir de uma folha de personagem

Até 30 segundos dão conta de um loop de feed, um sticker ou um clipe de reação. Mantenha uma imagem e troque os vídeos guia para montar uma biblioteca de gestos, como um aceno, um giro ou um dar de ombros, que parecem todos o mesmo personagem porque compartilham a mesma imagem de referência.

Coreografias e números de performance

Uma imagem de personagem mais um vídeo guia da coreografia que você quer: figurino e biotipo ficam fixados pela imagem, enquanto ritmo, peso e câmera vêm do material. O limite é a propriedade: você precisa dos direitos sobre a imagem e sobre o vídeo guia, e é responsável pelo uso do resultado.

Teste uma imagem antes de um render mais longo

Rode uma transferência de cinco segundos em 480p para ver se uma nova imagem de personagem mantém rosto, mãos e silhueta em movimento. É o jeito mais barato de descartar uma imagem ruim antes de usá-la num trabalho completo de 30 segundos.

Ver tutoriais dos principais casos de uso

Guia de prompt e dicas práticas

Monte a imagem do personagem

Corpo inteiro no quadro, pose neutra, fundo liso, luz uniforme. Essa imagem define o rosto, o figurino e as proporções de todos os clipes que você guiar com ela, então vale gerar e descartar algumas antes de decidir. Se nenhum rosto ou pessoa for encontrado nela, a tarefa é recusada com invalid_request. A imagem publicada veio deste prompt: “Full-body studio photograph of an adult female dancer standing in a neutral A-pose against a seamless grey backdrop, wearing a cropped burgundy tank top and high-waisted wide-leg trousers, barefoot, hair tied back, even soft studio lighting, sharp full-length framing, clean reference plate for character animation.”

Corte o vídeo guia nos segundos de que você precisa

A duração da saída é igual à da fonte, que precisa ter de 2 a 30 segundos, e você paga pelos segundos entregues. Envie o MP4 ou passe um link direto para um arquivo MP4 ou MOV; uma página da web que apenas reproduz o vídeo não é um arquivo, e a chamada falha com a cobrança reembolsada.

Use o prompt para o estilo, não para a identidade

prompt é opcional e aceita até 2000 caracteres. Ele orienta o estilo e o conteúdo da animação; a identidade fica com a imagem do personagem. Fixe seed quando quiser comparar duas execuções com o mesmo vídeo guia.

Confira o resultado antes de iterar

As duas entradas são obrigatórias e não são intercambiáveis: a identidade vem da imagem e o movimento, do vídeo. No modo animate, o cenário fica com a imagem do personagem; na execução de referência, o vídeo guia foi gravado numa cozinha e o resultado ficou no fundo cinza de estúdio da imagem, levando só o movimento e a câmera. Uma fonte mais longa não é comprimida, então corte antes de enviar.

Início rápido da API

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

Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.

Modelos relacionados e próximas tarefas

Não encontrou o modelo que precisa?

Conte qual modelo adicionar e para que você vai usá-lo. Os pedidos vão direto para quem decide os próximos modelos.

Transferir o movimento de um vídeo guia para uma imagem de personagem

O endpoint character-animation da API Wan 2.2 Animate recebe duas entradas obrigatórias, image_url e video_url, e transfere o movimento do vídeo guia para a pessoa na imagem. animation_mode escolhe a direção: animate mantém o cenário da imagem e move esse personagem, enquanto replace mantém o cenário do vídeo guia e troca a pessoa dele pela do personagem. A saída dura de 2 a 30 segundos, seguindo o vídeo guia, em 480p ou 720p.

Abrir o Playground

Transferir o movimento de um vídeo guia para uma imagem de personagem

Entradas obrigatórias: image_url (personagem) e video_url (vídeo guia)
Modos: animation_mode: animate (padrão) ou replace
Duração do vídeo guia: de 2 a 30 segundos; a saída acompanha essa duração
Níveis de resolução: 480p ou 720p, padrão 720p, também o nível de preço
Prompt: Opcional, até 2.000 caracteres, guia o estilo e o conteúdo do movimento
Entrada de vídeo: Upload MP4 de até 90MB, ou uma URL MP4 ou MOV

Modos: Animate mantém o cenário da imagem, replace o do vídeoanimation_mode decide qual cenário permanece. animate mantém o ambiente próprio da imagem do personagem e move esse personagem com o movimento do vídeo guia; replace mantém o fundo do vídeo guia e coloca o personagem da imagem no lugar da pessoa original.
Divisão de papéis: A identidade vem de image_url, o movimento de video_urlAs duas URLs são obrigatórias, e cada uma controla uma parte diferente do resultado. O prompt opcional, até 2.000 caracteres, guia o estilo e o conteúdo do movimento. Ele não decide quem aparece na tela, porque a identidade pertence à imagem do personagem.
Duração: Não existe um campo para definir a duraçãoA saída dura o mesmo que o vídeo em video_url, e esse vídeo guia precisa durar entre 2 e 30 segundos. O arquivo enviado é, portanto, também o ajuste de duração, então corte a fonte para o trecho exato que quer animar antes de enviar.

Onde Wan 2.2 Animate é forte

Um único modelo da Alibaba cobre animação e substituição

A Alibaba lançou o Wan2.2-Animate-14B em 19 de setembro de 2025 como um único modelo para animação e substituição de personagem, com pesos abertos. Esta API coloca os dois comportamentos atrás de um único endpoint: animation_mode alterna entre eles, e todos os outros campos, da resolução ao seed, funcionam da mesma forma em ambos os modos.

Movimento do corpo e expressão facial vêm ambos do vídeo guia

Segundo o artigo Wan-Animate da Alibaba, o modelo usa sinais de esqueleto alinhados espacialmente para reproduzir o movimento do corpo e características faciais implícitas extraídas das imagens de origem para recriar expressões. Um vídeo guia que mantém o corpo e o rosto do performer visíveis durante toda a duração dá ao modelo os dois sinais com que trabalhar.

O modo replace reaproveita imagens que você já tem
Definir animation_mode como replace troca a pessoa em video_url pelo personagem em image_url enquanto o fundo e o movimento de câmera do vídeo permanecem. Uma locação filmada uma única vez pode então carregar personagens diferentes, cada um fornecido como sua própria imagem, sem regravar a cena para cada versão.
Só a resolução e os segundos entregues alteram o preço
A cobrança é por segundo de saída, e a resolução é o único campo que define a tarifa, com 480p e 720p como os dois níveis. animation_mode, prompt e seed não mudam a tarifa. Cada tarefa é primeiro orçada no máximo de 30 segundos, e a diferença é reembolsada quando liquidada de acordo com a duração real.
A imagem do personagem precisa conter um rosto ou uma pessoa
Quando nenhum rosto ou pessoa é encontrado em image_url, a tarefa é rejeitada com invalid_request. A imagem do personagem também é a fonte de toda a aparência, então a própria orientação do endpoint recomenda um plano de corpo inteiro com silhueta clara e luz uniforme.
Um seed para comparar tomadas
seed aceita qualquer inteiro de 0 a 2.147.483.647, e 0 solicita um seed aleatório. Manter um valor fixo enquanto muda apenas outra entrada, como prompt ou animation_mode, facilita comparar duas tomadas feitas com o mesmo vídeo guia.

Para quem é Wan 2.2 Animate

Donos de personagens e IP
Dar novos movimentos a um personagem aprovado
Uma equipe com um design de personagem finalizado pode combinar essa imagem estática com uma performance gravada no modo animate. A imagem pode ser desenhada ou renderizada, desde que haja uma pessoa visível nela. A aparência permanece em image_url enquanto o ritmo e os gestos vêm do vídeo guia, então um novo clipe não exige nova renderização do personagem.
Editores de vídeo
Trocar a pessoa de uma cena já filmada
Definir animation_mode como replace para colocar outro personagem em uma tomada existente. O fundo e o movimento de câmera vêm do vídeo guia, então uma locação pode carregar vários personagens. O consentimento das pessoas na filmagem e na imagem do personagem continua necessário.
Criadores de dança e fitness
Fazer um personagem executar uma rotina completa
Combinar uma imagem de personagem em corpo inteiro com até 30 segundos de coreografia ou uma sequência de treino no modo animate. A saída dura o mesmo que a rotina, então um vídeo guia mais longo retorna um clipe mais longo cobrado pela mesma tarifa por segundo da sua resolução.
Desenvolvedores de aplicativos
Oferecer modelos de movimento dentro de um produto
Um app pode manter uma biblioteca de clipes guia curtos e pedir ao usuário apenas uma imagem de personagem de si mesmo ou de um personagem sobre o qual tenha direitos. Cada requisição precisa então apenas das duas URLs e de um animation_mode, com prompt e seed adicionados quando um modelo exigir.

Como chamar a API Wan 2.2 Animate

Escolher animate ou replace antes de tudo
animation_mode determina qual cenário a saída mantém: animate para o cenário próprio da imagem do personagem, replace para o cenário do vídeo guia. O padrão é animate se o campo for deixado sem definir.
Fornecer uma imagem de personagem e um vídeo guia
image_url recebe o personagem como upload JPEG, PNG ou WebP. video_url recebe o vídeo guia como upload MP4 de até 90MB ou como URL MP4 ou MOV. Ambos os campos são obrigatórios.
Manter o vídeo guia entre 2 e 30 segundos
Corte a filmagem antes de enviar para o trecho que quer animar, porque a saída dura exatamente o mesmo que a entrada. Um vídeo guia com menos de 2 segundos ou mais de 30 é rejeitado com invalid_request antes de qualquer cobrança.
Escolher um nível de resolução
Definir resolution como 480p ou 720p, ou deixar de fora para obter 720p. É o único campo que muda a tarifa por segundo, então uma passagem em 480p é uma forma barata de conferir uma nova combinação de imagem e vídeo.
Adicionar um prompt só se o movimento precisar de direção
Deixe prompt de fora para uma transferência simples, ou adicione até 2.000 caracteres sobre o estilo do movimento, como ritmo ou energia. Mantenha a aparência fora dele, já que o visual do personagem é lido de image_url.
Definir um seed, enviar e coletar o resultado
Dê a seed um valor fixo de 1 a 2.147.483.647 ao planejar comparar tomadas, ou 0 para um seed aleatório. A tarefa roda de forma assíncrona, então guarde o task id retornado e consulte-o por polling, ou registre uma URL de callback.

Exemplos resolvidos com Wan 2.2 Animate

Fazer um personagem de corpo inteiro passar por uma rotina de dança
Combinar uma imagem de personagem em corpo inteiro com um vídeo guia de uma rotina de dança no modo animate. O personagem executa a coreografia, o fundo da imagem do personagem permanece no lugar, e o clipe dura exatamente o mesmo que o vídeo de dança.
```
Smooth, energetic dance movement with confident posture and fluid arm gestures
```
Substituir um performer em uma cena já filmada
Definir animation_mode como replace para trocar a pessoa de um vídeo guia pelo personagem de image_url. A locação e o trabalho de câmera do vídeo guia permanecem, então o novo personagem aparece dentro de uma filmagem feita para outra pessoa.
```
Natural, expressive movement matching the pace of the original performance
```
Comparar dois seeds no mesmo vídeo guia
Rodar o mesmo image_url e video_url duas vezes com animation_mode em animate, mudando apenas seed, para ver o quanto o resultado varia antes de escolher um valor para a renderização final.
```
Subtle, natural motion with relaxed shoulders and a steady gaze toward camera
```

Perguntas sobre a API Wan 2.2 Animate

Trate image_url e video_url como as duas entradas que decidem o resultado: a imagem do personagem fornece a identidade e, no modo animate, o fundo; o vídeo guia fornece o movimento e, no modo replace, o cenário. Reserve prompt para notas sobre ritmo ou clima e deixe a aparência para a imagem. Corte o vídeo guia para o trecho mais curto que mostra o movimento necessário, já que um clipe mais curto custa menos para testar e é mais fácil de avaliar.