Wan API — API de geração de vídeo Wan 3.0 e Seedance
O que é Wan API
Wan API é uma plataforma independente de geração de vídeo que atende a família Wan 3.0 e os modelos Seedance 2.x com uma única conta, uma só URL base de API e um mesmo saldo pré-pago. Ela foi feita para desenvolvedores e estúdios que preferem comparar especificações, preço por segundo e limites de entrada em um só lugar, em vez de percorrer páginas de vários fornecedores, e então chamar o modelo adequado a cada cena. As requisições saem pelo Playground do navegador ou pela API REST em api.wanapi.app, e o acompanhamento da tarefa devolve uma URL assinada com o resultado. Gerar exige conta com saldo: o login é feito com Google e a cobrança desconta do saldo, sem pacote mensal de vídeo. A plataforma informa que não tem vínculo nem endosso da Alibaba, da Wan ou da ByteDance, cujos nomes identificam os modelos de terceiros que ela expõe.
Como funciona Wan API
Todas as requisições seguem o mesmo caminho: enviar, acompanhar, buscar. A conta entra com Google e mantém saldo pré-pago em dólares; a chave criada em API key settings autentica as chamadas de servidor com Authorization: Bearer em https://api.wanapi.app. O cliente envia uma combinação dos 14 campos nativos de geração (prompt, quadros, referências, resolução, proporção, duração, áudio, seed, prompt_extend…) ao endpoint do ID de modelo escolhido, e a plataforma valida as combinações de campos antes de criar a tarefa. A resposta devolve um ID de tarefa, que é o único dado necessário depois: consultar não inicia nova geração, não cobra duas vezes nem prolonga o tempo de disponibilidade dos arquivos. O custo é a tarifa da resolução multiplicada pelos segundos faturáveis, em que contam tanto os segundos de vídeo de referência quanto os de saída, enquanto texto, imagem e áudio não somam segundos; com duração automática ou vídeo de referência, até 30 segundos são reservados e depois ajustados ao uso medido, com devolução da diferença. Ao concluir, a consulta traz uma URL assinada de CDN para reproduzir ou baixar, e os arquivos seguem a política de retenção da plataforma — convém copiar para storage próprio o que precisa ficar.
Benefícios de Wan API
A vantagem prática é uma única superfície de integração para duas famílias de modelos: um base URL, uma chave, um saldo pré-pago e o mesmo padrão de acompanhamento, então trocar de um clipe Wan 3.0 para Seedance 2.5 não exige novas credenciais nem um segundo cliente. As tarifas são por segundo, exibidas ao lado dos preços oficiais de tabela, e a pré-visualização do corpo nativo no Playground evita adivinhar quais dos 14 campos cada modelo aceita. As páginas de modelo publicam no mesmo formato os limites rígidos — saída de 2 a 30 segundos, resoluções até 2K e 4K nas variantes Pro, quantidade de referências, formatos e tamanhos — o que torna rápida a checagem de viabilidade. Na operação ajudam a consulta de saldo somente leitura, a exclusão de tarefas encerradas e regras explícitas de falha (geração que falha libera a reserva, acompanhar não cobra de novo, timeout não dispara reenvio automático), o que reduz o risco de pagar duas vezes pela mesma ideia.
Prós e Contras de Wan API
Prós
- Oito modelos Wan e Seedance sob uma única chave e um saldo
- Cobrança por segundo com os preços oficiais de tabela ao lado
- O Playground mostra o corpo nativo exato de cada modelo
- Limites de duração, resolução, formatos e quantidade de referência publicados
- Consulta de saldo e exclusão de tarefa valem para todos os modelos
Contras
- Sem plano gratuito: é preciso conta com fundos
- Nada anunciado de pacote mensal, webhook, cancelamento de tarefa ou chave de idempotência
- Segundos de vídeo de referência também são faturáveis: 5 s de saída podem custar 10
- Os arquivos dependem da política de retenção da plataforma
- Revendedor independente, sem vínculo com Alibaba, Wan ou ByteDance
Recursos principais de Wan API
Oito modelos de vídeo, uma única chave
As quatro variantes do Wan — 3.0, 3.0 Prime, 3.0 Pro e 3.0 Prime Pro — ficam ao lado do Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast e Seedance 2.0 Mini na mesma plataforma. GET /v1/models mostra o que a chave atual alcança, e cada modelo tem seu ID documentado, como wan3.0-video ou w3.0-video-prime-pro.
Modos de entrada multimodais
A requisição pode trazer só um prompt de texto, um primeiro ou último quadro, ou um conjunto de referências: até 10 imagens, 5 clipes de vídeo e 5 de áudio, além de um documento ou página pública. Os modos de quadro-chave e de referência não se misturam na mesma requisição; o prompt aceita até 20.000 caracteres.
Playground com pré-visualização da requisição nativa
Cada página de modelo embute um Playground que monta o corpo nativo plano do modelo escolhido, omite campos opcionais vazios e confere a disponibilidade antes de enviar. Ele usa a sessão do site e o mesmo saldo pré-pago, sem colar chave nenhuma no navegador.
API assíncrona de tarefas
Enviar a um endpoint de modelo devolve na hora um ID de tarefa público; os estados são pending, processing, completed e failed, e a resposta concluída traz uma URL assinada da Bunny CDN que toca ou baixa sem cabeçalho Authorization. O POST /v1/responses aceita espera síncrona, modo em segundo plano ou server-sent events.
Nível de moderação define o preço
O campo opcional nsfw_checker escolhe a moderação estrita ou mais permissiva no Wan 3.0 e no Wan 3.0 Prime, e cada valor tem seu preço por segundo próprio. As variantes Pro aceitam apenas false. Uma submissão recusada pela moderação pode ser reenviada com o outro valor mantendo o mesmo ID público do modelo.
Consulta de saldo e limpeza de tarefas
GET /v1/balance devolve o saldo utilizável da conta e o limite restante da chave que chama. DELETE /v1/tasks/{task_id} apaga uma tarefa encerrada junto com os vídeos e o último quadro armazenados. Os textos do site também ficam disponíveis para leitura automática em /llms.txt e /llms-full.txt.
Casos de uso de Wan API
- Times de produto e e-commerce: transformar a foto parada de um produto em um reveal lento ou órbita de câmera e checar forma, reflexos e rótulos antes de usar o clipe na campanha.
- Roteiro, storyboard e social: sem filmagem nem arte-chave, converter uma cena escrita em prévia em movimento e julgar luz, direção de câmera e ritmo num clipe curto.
- Agências que trabalham por brief: fornecer um documento enxuto ou uma página pública para que uma ideia escrita vire ponto de partida visual com uma audiência e uma mensagem.
- Times de engenharia integrando vídeo: comparar lado a lado tarifas, durações e limites de referência de Wan e Seedance e manter o modelo escolhido sob uma única chave e um saldo.
- Construção de personagem por referência: dar a cada arquivo enviado um papel — aparência, movimento, som — para que cenas mais longas do Seedance 2.5 mantenham personagens e locações legíveis.
Perguntas frequentes de Wan API
É um serviço oficial da Alibaba ou da ByteDance?
Não. A Wan API opera de forma independente no wanapi.app, sem vínculo nem endosso da Alibaba, da Wan ou da ByteDance; esses nomes identificam os modelos de terceiros que ela expõe, e as marcas pertencem aos seus donos.
Preciso de assinatura para gerar vídeo?
Nenhum pacote mensal de vídeo é oferecido. O acesso depende de conta habilitada com saldo, e o preço é a tarifa da resolução vezes os segundos faturáveis.
Quais segundos entram na conta?
Os segundos de vídeo de referência mais os da saída gerada. Texto, imagem e áudio não somam segundos, e desligar o áudio gerado não reduz a tarifa.
Dá para cancelar a tarefa ou reenviar automaticamente?
Não há cancelamento, webhook nem chave de idempotência anunciados, e envios não são repetidos nem trocados de modelo sozinhos. Depois de timeout ou sem o ID, consulte primeiro a tarefa existente: outro POST pode criar um segundo job pago.
Por quanto tempo os vídeos ficam disponíveis?
A tarefa concluída devolve uma URL assinada de CDN que não exige chave, mas os arquivos seguem a política de retenção da plataforma. Acompanhar não prolonga essa disponibilidade — copie o que importa.
Qual modelo escolher no primeiro teste?
Wan 3.0 cobre de 480p a 1080p com a tarifa mais baixa; Prime é um modelo à parte, com preços próprios; só as variantes Pro chegam a 2K e 4K. Cada página do Seedance traz duração e cota de referência próprias, então escolha pelo entregável e não presuma resolução alta no modelo barato.
O mesmo corpo de requisição vale para todos os modelos?
Os quatro modelos Wan compartilham os 14 campos nativos de geração, mas valores de resolução, ID do modelo e suporte a nsfw_checker mudam: as variantes Pro aceitam apenas o valor permissivo. Campos desconhecidos são rejeitados, então confira antes a página do modelo de destino.
Como usar Wan API
- Entre no wanapi.app com Google e adicione fundos nas configurações da conta: só ter conta no site não libera a geração.
- Crie a chave em API key settings e mantenha-a apenas no servidor; o Playground usa a sessão do site e o mesmo saldo.
- Escolha o modelo no panorama ou via
GET /v1/modelse confira na página dele as resoluções, a faixa de duração e os limites de referência. - Monte a requisição no Playground daquele modelo e copie o corpo nativo pré-visualizado, ou escreva o JSON à mão com o ID documentado.
- Ao enviar, guarde na hora o ID de tarefa retornado e comece o acompanhamento a cada cinco segundos, aumentando o intervalo em erros temporários.
- Reproduza ou baixe pela URL assinada da resposta concluída e copie o arquivo para o seu storage antes de acabar a retenção.
Wan API Alternativas
O Seedance 3.0 transforma texto, imagens, clipes de vídeo e áudio em vídeos com som, e edita uma parte do clipe sem gerar o restante de novo.
Wery é um estúdio de IA virtual que encaminha um objetivo para agentes especializados em vídeo, imagem, música e documentos, mantendo personagens e ativos do projeto consistentes.
Estúdio de vídeo e imagem com IA que gera a partir de texto ou imagem e usa controle de quadros-chave com os modelos Seedance, Kling, Wan e Vidu, tudo em um único saldo de créditos.
Estúdio no navegador para gerar vídeo, imagem e música com modelos Grok Imagine, Kling e GPT Image. Créditos diários gratuitos, sem necessidade de cadastro.
A SeaMove AI é uma plataforma de geração de vídeo e imagem com IA que oferece os modelos Seedance 2.0 e Seedance 2.5 para criar vídeos a partir de texto, imagens e referências. Oferece continuidade multi-cena, controle de nível de direção e sincronização audiovisual para criadores e estúdios.
Transforma dois retratos separados em um vídeo vertical de dueto de rap de 15 segundos em um palco laranja, com microfone compartilhado e a trilha sonora original. Há uma prévia gratuita em 480P.
Mareel é um espaço de trabalho completo de geração de vídeos e imagens com IA que reúne mais de 40 modelos líderes em uma única conta com saldo de créditos compartilhado, para criadores, profissionais de marketing e equipes de e-commerce.
Kinovi é uma API REST que executa modelos publicados de IA para vídeo, imagem e áudio em um único endpoint. Envie o ID do modelo para createTask, consulte recordInfo e pague pelo uso com um saldo de créditos compartilhado.
Um gerador de vídeos de desenho com IA que transforma um roteiro ou prompt em vídeo animado com o mesmo personagem em cada cena, narração e trilha sonora por IA e direitos comerciais incluídos.
Gemini Omni é um gerador e editor de vídeo com IA online que transforma um prompt de texto ou imagem de referência em vídeo e depois refina cada cena com edições conversacionais, mantendo personagens e cenário consistentes.
O Kling 4.0 transforma texto, imagens e até 15 recursos de referência Omni em vídeo IA cinematográfico, com cenas de 30 segundos, 10 quadros-chave e saída 4K HDR.
O Gemini Omni é um gerador e editor de vídeo com IA multimodal e conversacional. Ele combina texto, imagens, vídeo e áudio para criar clipes cinematográficos com áudio nativo.