

Como Usar o Wan 2.7: Tutorial de Vídeo com IA
Aprenda a usar o Wan 2.7 no APIMart para gerar vídeos com IA — configure sua chave de API e domine os modos Texto, Imagem e Edição passo a passo.
Quer criar vídeos com IA sem uma curva de aprendizado íngreme? O Wan 2.7, o mais recente gerador de vídeos com IA da Alibaba, facilita a produção de clipes de alta qualidade em minutos. Acessível pelo APIMart, a ferramenta suporta os modos Texto-para-Vídeo, Imagem-para-Vídeo, Edição de Vídeo e Referência-para-Vídeo, oferecendo flexibilidade para diferentes projetos.
Veja um resumo rápido do que você aprenderá:
- Configure o APIMart: Crie uma conta, obtenha uma chave de API e comece com pagamento por uso (a partir de $0,0664/segundo em 720p).
- Recursos principais: Gere vídeos a partir de texto, anime imagens estáticas ou edite filmagens existentes.
- Guia passo a passo: Crie prompts eficazes, escolha o modo certo e refine os resultados.
Sem necessidade de hardware avançado e com um fluxo de trabalho simples na nuvem, você pode começar a experimentar hoje. Vamos lá!
Configurando o Wan 2.7 pelo APIMart

Criando Sua Conta no APIMart
Acesse apimart.ai e crie uma conta gratuita ou organização. Depois de entrar, vá até Gerenciamento de Chave de API para gerar sua chave única. Certifique-se de copiar e armazenar a chave com segurança imediatamente — ela é exibida apenas uma vez. Você precisará dessa chave como Bearer Token no cabeçalho Authorization em cada requisição de API.
Não se esqueça de adicionar saldo à sua conta antes de começar. O APIMart usa o modelo de pagamento por uso, então você paga apenas pelo que utilizar — sem assinaturas.
Depois de configurar e financiar sua conta, você está pronto para confirmar os requisitos do sistema.
Requisitos do Sistema
Você não precisa de um computador potente, pois todo o processamento de vídeo acontece na nuvem. Veja o que é necessário:
| Requisito | Detalhes |
|---|---|
| Navegador | Qualquer navegador moderno como Chrome, Firefox ou Edge |
| Internet | Conexão estável para chamadas de API e download de vídeos |
| Armazenamento | Espaço suficiente para salvar arquivos .mp4 (links de download expiram após 24 horas) |
| Ferramentas | Qualquer cliente HTTP, como cURL, Postman, Python ou Node.js |
Faça o download dos vídeos dentro de 24 horas para não perder o acesso aos arquivos.
Agora, vamos localizar o Wan 2.7 no APIMart.
Encontrando o Wan 2.7 no APIMart
Encontrar o Wan 2.7 é simples. Acesse diretamente apimart.ai/model/wan-2-7 ou localize-o na seção de referência de API do seu painel. A plataforma oferece três versões do modelo: wan2.7, wan2.7-r2v e wan2.7-videoedit. Cada uma tem uma finalidade exclusiva, mas todas compartilham o mesmo preço: $0,0664 por segundo em 720p e $0,1096 por segundo em 1080p [2].
Antes de programar, aproveite o Playground integrado. Essa ferramenta permite experimentar prompts e ajustar parâmetros. É uma forma rápida de ver o desempenho do modelo antes de integrá-lo ao seu projeto. Os vídeos ficam prontos geralmente em 30 a 90 segundos e contam com SLA de 99,9% de uptime [2]. Com sua chave de API salva e a conta financiada, você está pronto para gerar vídeos.
Recursos Principais do Wan 2.7

Com sua conta configurada, vamos explorar os recursos principais do Wan 2.7. Projetado para aprimorar sua criação de vídeos, o Wan 2.7 oferece três modos principais: Texto-para-Vídeo, Imagem-para-Vídeo (com sub-modos) e Edição de Vídeo. Cada um oferece um ponto de partida único para seus projetos.
Texto-para-Vídeo: Das Palavras às Imagens
O Texto-para-Vídeo (T2V) é a forma mais simples de criar conteúdo em vídeo. Basta escrever uma descrição detalhada e o Wan 2.7 gera um clipe de até 15 segundos em 1080p HD a 30fps. A ferramenta lida com prompts complexos que incluem sujeito, movimento, iluminação e instruções de câmera ao mesmo tempo.
Para obter os melhores resultados, estruture seu prompt assim: [Sujeito] + [Ação/Movimento] + [Ambiente] + [Iluminação] + [Câmera] + [Estilo/Atmosfera]. Por exemplo: "Um barista prepara latte art em um café aconchegante, com iluminação âmbar quente, aproximação lenta, estilo cinematográfico."
Dicas para criar prompts eficazes:
- Seja específico com movimentos de câmera como "pan lento para a esquerda" ou "órbita".
- Use verbos de ação como "despeja" ou "caminha" em vez de adjetivos vagos.
- Adicione um negative prompt (ex.: "borrado, distorcido, estático") para minimizar artefatos indesejados.
- Para prompts curtos, ative a opção
prompt_extendpara enriquecer automaticamente sua descrição e melhorar a qualidade [3].
"O prompt é o roteiro. Quando você quer os melhores prompts para o Wan 2.7, está realmente criando ritmos, lentes e som em linguagem simples." - Ryan Barnett, Tech Writer [9]
Para economizar, comece os rascunhos em 720p ($0,0664/seg) antes de finalizar em 1080p ($0,1096/seg) [2]. A seguir, veja como o modo Imagem-para-Vídeo usa visuais para criar animações fluidas.
Imagem-para-Vídeo e Animações de Primeiro e Último Quadro
O modo Imagem-para-Vídeo (I2V) dá vida a imagens estáticas preservando sua aparência e composição. Basta fornecer uma ou duas URLs de imagem pelo parâmetro image_urls, e o APIMart processa automaticamente sua requisição no modo I2V [3].
Este modo inclui duas sub-opções:
- Primeiro Quadro para Vídeo: Comece com uma única imagem, e o modelo gera movimento progressivo a partir desse quadro. Ótimo para animar fotos de produtos, retratos ou ilustrações.
- Primeiro e Último Quadro: Forneça duas imagens — uma para o início e outra para o fim. O modelo cria uma transição suave entre elas, oferecendo controle preciso sobre a animação.
Ao usar I2V, concentre seus prompts no movimento e no comportamento da câmera, pois as imagens já definem os visuais. Por exemplo: "zoom lento para fora", "olhos piscam suavemente", "câmera desliza para a direita."
A ilustradora Ming Li compartilhou sua experiência com este recurso:
"O recurso de imagem-para-vídeo economizou muito tempo de pós-produção. Basta fornecer os quadros-chave e deixar o WAN 2.7 fazer o resto." [2]
Outra vantagem: a proporção de tela é definida automaticamente com base nas dimensões da imagem de entrada, sem necessidade de ajustes manuais [3]. Quando você precisa ajustar filmagens existentes em vez de começar do zero, o modo de Edição de Vídeo é a melhor opção.
Edição e Reestilização de Vídeo
O modelo wan2.7-videoedit permite modificar clipes de vídeo existentes usando instruções em linguagem simples. Em vez de criar uma nova cena, você simplesmente descreve as alterações desejadas — como "substituir o fundo por uma praia ao pôr do sol" ou "desacelerar o pan da câmera" — e o modelo as aplica mantendo o restante da filmagem intacto [1].
Para melhores resultados, use verbos de ação diretos como substituir, remover, iluminar, desacelerar, reestilizar. Deixe claro o que deve permanecer inalterado para evitar edições indesejadas. Por exemplo: "Substituir o fundo por uma floresta. Manter o sujeito e a iluminação inalterados." Essa clareza minimiza erros [7].
Além disso, o parâmetro video_urls suporta continuação de vídeo, que permite estender um clipe existente de forma natural. Perfeito para alongar sequências sem precisar regravar ou criar novos prompts [3].
"O WAN 2.7 é sobre direcionar o clipe... O Wan 2.6 era sobre obter um clipe." - MkSaaS, Tutorial Author [1]
Veja um resumo de quando usar cada modo e as entradas necessárias:
| Modo | Entrada | Ideal Para |
|---|---|---|
| Texto-para-Vídeo | Apenas prompt de texto | Gerar novas cenas do zero |
| Imagem-para-Vídeo (Primeiro Quadro) | 1 imagem em image_urls | Animar uma foto ou ilustração |
| Primeiro e Último Quadro | 2 imagens em image_urls | Controlar início e fim de um plano |
| Continuação de Vídeo | Clipe existente em video_urls | Estender uma sequência de vídeo |
| Edição de Vídeo | Vídeo fonte + instruções de edição | Reestilizar ou modificar filmagens existentes |
Passo a Passo: Criando Seu Primeiro Vídeo com o Wan 2.7
Escolhendo o Modo Correto
O Wan 2.7 oferece vários modos adaptados a diferentes tipos de criação de vídeo. Veja como escolher o certo para seu projeto:
- T2V (Texto-para-Vídeo): Ideal para transformar ideias em clipes visuais.
- I2V (Imagem-para-Vídeo): Anime fotos em sequências dinâmicas.
- Edição de Vídeo: Modifique e aprimore filmagens existentes. Para resultados alternativos de alta fidelidade, explore também o MiniMax-Hailuo-02.
- R2V (Referência-para-Vídeo): Use entradas multimídia como imagens, clipes de vídeo ou áudio para garantir consistência em seu vídeo.
Se não tiver certeza, o APIMart selecionará automaticamente o modo adequado com base na sua entrada. Para projetos avançados, o ID de modelo wan2.7-r2v permite até 5 referências mistas, dando mais controle sobre o resultado final.
Preparando Suas Entradas e Configurações
Antes de começar, certifique-se de que suas entradas e configurações estão prontas. Veja um guia rápido:
-
Crie Seu Prompt: Estruture-o como: [Sujeito] + [Ação] + [Ambiente] + [Movimento de Câmera] + [Velocidade] + [Estilo].
Exemplo: "Um chef emprata um prato em uma cozinha moderna, iluminação quente acima, aproximação lenta, cinematográfico."- Se o seu prompt tiver menos de 30 palavras, ative
prompt_extendpara adicionar detalhes cinematográficos automaticamente.
- Se o seu prompt tiver menos de 30 palavras, ative
-
Requisitos de Arquivos:
- Use URLs HTTPS públicas para imagens/vídeos.
- Para edição ou continuação, os arquivos devem estar em formato MP4 ou MOV, ter de 2 a 10 segundos e pesar menos de 100MB.
-
Defina os Parâmetros Principais:
Ajuste estas configurações para resultados ideais:Parâmetro Valor Recomendado Observações resolution720PUse 1080Papenas para renders finais.duration5Varia de 2 a 15 segundos (T2V/I2V). size16:9Aplica-se ao T2V; I2V detecta automaticamente. negative_prompt"blurry, distorted, low quality" Ajuda a reduzir problemas visuais comuns. seedQualquer inteiro não negativo Salve para resultados consistentes. Começar com resolução 720P pode economizar cerca de 39% por segundo — $0,0664/seg comparado a $0,1096/seg para 1080P no APIMart.
Fazendo Sua Primeira Chamada de API
A geração de vídeos no APIMart funciona de forma assíncrona. Veja como funciona:
-
Envie Sua Requisição: Envie uma requisição JSON, como este exemplo mínimo de T2V:
{ "model": "wan2.7", "prompt": "A chef plates a dish in a modern kitchen, warm overhead lighting, slow push-in, cinematic.", "resolution": "720P", "duration": 5, "size": "16:9", "negative_prompt": "blurry, distorted, low quality", "prompt_extend": true } -
Receba um
task_id: Você receberá umtask_idpara acompanhar o progresso. -
Consulte o Status: Verifique o endpoint de status a cada 15 segundos. Quando o status mudar para
SUCCEEDED, faça o download imediatamente — a URL expira após 24 horas.
Após o download, você pode revisar e refinar seu vídeo conforme necessário.
Revisando e Ajustando Seus Resultados
Quando seu vídeo estiver pronto, é hora de refiná-lo. Assista ao clipe com atenção para identificar problemas como deriva de movimento (quando o sujeito muda no meio do clipe) ou movimento estático. Use estas dicas para melhorar os resultados:
- Ajuste Variáveis: Modifique um elemento por vez, como a indicação de câmera, o verbo de ação ou a duração. Esse método ajuda a identificar o que funciona melhor sem reformular o prompt inteiro.
- Bloqueie o Seed: Salve o valor de
seedde um resultado bem-sucedido. Isso garante que você possa reproduzir o mesmo resultado posteriormente.
"Bloqueie [o seed] assim que encontrar um bom resultado. É o único parâmetro que torna seus resultados reproduzíveis entre execuções." - Dora, WaveSpeed Blog
Para clipes que parecem estáticos demais, tente adicionar termos cinematográficos como "dolly in", "slow push" ou "handheld". Se precisar modificar uma parte específica do vídeo, mude para wan2.7-videoedit e forneça instruções claras, como "substituir o fundo por uma floresta, mantendo o sujeito e a iluminação inalterados." Assim, você pode refinar elementos específicos sem recomeçar do zero.
Solução de Problemas e Dicas
Ao trabalhar nos seus projetos de vídeo, você pode encontrar alguns obstáculos. Abaixo, você encontrará soluções para problemas comuns e dicas práticas para melhorar seus resultados.
Problemas Comuns e Como Resolvê-los
Muitos problemas do Wan 2.7 decorrem de erros de configuração. Veja um guia rápido para problemas comuns e suas soluções:
| Problema | Causa Provável | Solução |
|---|---|---|
| Requisição falha completamente | Incompatibilidade de região | Certifique-se de que sua chave de API e URL do endpoint são da mesma região [5] |
| Vídeo parece uma foto estática | Movimento insuficiente no prompt | Inclua verbos de ação como "vira a cabeça" ou direções de câmera como "dolly forward" [8] |
| Sujeito muda no meio do clipe | Prompt sobrecarregado | Simplifique para focar em um sujeito, uma ação e um local [8] |
| Erro 400 no envio | Conflito de parâmetros | Evite enviar audio_url junto com image_urls ou video_urls [3] |
| Não consigo acessar a URL do vídeo | Link expirado | Faça o download do vídeo dentro de 24 horas após a geração [5][2] |
Requisitos de Arquivo: Os vídeos de entrada para continuação devem estar em formato MP4 ou MOV, ter entre 2 e 10 segundos e pesar menos de 100MB. Os arquivos de áudio precisam estar em WAV ou MP3, com menos de 15MB [3]. Arquivos que não atendem a esses critérios podem falhar silenciosamente ou gerar um erro 400.
Depois de resolver esses problemas comuns, você pode se concentrar em aprimorar seus vídeos para melhores resultados.
Dicas para Melhorar a Qualidade do Vídeo
A qualidade do seu prompt afeta diretamente o seu vídeo. Um prompt bem estruturado entrega resultados melhores. Use a fórmula: [Sujeito] + [Ação] + [Ambiente] + [Iluminação] + [Câmera] + [Estilo/Atmosfera] [6]. Isso garante que o modelo tenha contexto suficiente para criar um resultado com propósito.
Para o modo Imagem-para-Vídeo, concentre seu prompt no que deve se mover e em como a câmera deve se comportar. Evite redescrever a imagem wan2.7 em si. Se elementos específicos precisarem permanecer consistentes, como a forma ou cor de um produto, deixe isso claro no prompt para evitar distorções.
Comece os rascunhos em resolução 720P. Quando estiver satisfeito com o movimento, mude para 1080P para o render final [2].
No modo Primeiro e Último Quadro, a qualidade das imagens de entrada importa mais do que o prompt de texto. Para melhores resultados, use um par de imagens com uma relação espacial clara. Um par bem combinado produzirá resultados mais consistentes do que até mesmo o prompt de texto mais refinado [4].
Usando o Wan 2.7 com Responsabilidade
O Wan 2.7, disponível no APIMart, é licenciado para uso comercial, tornando-o uma excelente ferramenta para projetos profissionais [2]. No entanto, é importante seguir diretrizes éticas. Evite usar imagens ou áudio identificáveis de pessoas reais sem permissão explícita. Se estiver usando imagens ou vídeos de referência, certifique-se de ter os direitos de uso.
O APIMart também inclui o parâmetro booleano watermark, que permite adicionar o rótulo "AI Generated" aos seus vídeos [3]. Ativá-lo para conteúdo público é uma forma simples de ser transparente sobre o envolvimento da IA. Para projetos que exigem estilos cinematográficos diferentes, explore também a API Google Veo 3.1.
Conclusão
Agora você tem o essencial para criar seu primeiro vídeo com IA usando o Wan 2.7. Os passos são simples: configure sua conta no APIMart, adicione saldo, obtenha sua chave de API e comece a experimentar com uma requisição básica de Texto-para-Vídeo em resolução 720P. Essa abordagem mantém os custos gerenciáveis enquanto você se familiariza com o processo.
Vá passo a passo: comece com clipes curtos de 5 segundos, anote os valores de seed de saídas bem-sucedidas e avance gradualmente para vídeos mais longos e de maior qualidade. Com o tempo, você entenderá melhor qual modo atende melhor às suas necessidades — seja Texto-para-Vídeo para gerar cenas originais, Imagem-para-Vídeo para dar vida a um visual específico, ou Primeiro e Último Quadro para controle preciso sobre início e fim dos clipes.
A $0,0664 por segundo para 720P e $0,1096 por segundo para 1080P via APIMart — um desconto de 20% em relação ao preço oficial [2] — um clipe de teste de 5 segundos em 720P custa menos de $0,34. É uma forma acessível de iniciar sua jornada criativa.
Perguntas Frequentes
Como manter personagens consistentes em vários clipes?
Para manter um design de personagem consistente no Wan 2.7, use o recurso Referência-para-Vídeo (R2V). Veja como fazer isso de forma eficaz:
- Forneça até cinco imagens de referência ou clipes de vídeo de alta qualidade. Eles devem mostrar o personagem de diferentes perspectivas, como frente, lado e três-quartos. Essa variedade ajuda o sistema a compreender melhor a aparência do personagem.
- Ao escrever seu prompt de texto, referencie esses ativos pelo índice atribuído (ex.: "imagem 1" ou "clipe 2"). Referências claras garantem resultados precisos.
- Para configurações mais complexas, considere criar um painel de referência em grade 9x. Essa grade pode exibir vários ângulos ou expressões, dando ao sistema uma compreensão mais ampla do personagem. Combine isso com descrições consistentes e detalhadas em cada prompt para os melhores resultados.
Ao combinar referências visuais com prompts bem elaborados, você pode obter uma representação de personagem uniforme e polida.
O que fazer se meu vídeo tiver movimento estranho ou tremido?
Para resolver problemas de movimento ou tremido nos vídeos, use um negative prompt para minimizar artefatos indesejados como borrão ou instabilidade. Essa técnica ajuda a refinar o resultado para um visual mais suave.
Para transições de imagem para vídeo, comece com uma imagem fonte limpa — evite usar uma com fundo poluído ou agitado, pois isso pode introduzir instabilidade. Se notar tremido no meio do clipe, geralmente é causado por iluminação inconsistente ou mudanças na distância focal. Manter esses elementos estáveis é fundamental para reduzir perturbações.
Além disso, simplificar o prompt ou limitar o movimento da câmera pode contribuir muito para manter um movimento suave e estável ao longo do seu vídeo.
Como posso estimar meu custo antes de gerar um clipe?
Para calcular o custo do seu vídeo no APIMart, basta multiplicar a duração do clipe pela taxa por segundo da resolução selecionada. O Wan 2.7 segue um modelo de precificação direto baseado nas configurações de saída. Revisar os detalhes de preços com antecedência pode ajudá-lo a planejar melhor seu orçamento. Lembre-se, porém, de que esses cálculos são apenas estimativas — o custo final será determinado pelo resultado real gerado pelo modelo.
Escolha o modelo que você quer no marketplace
Teste modelos de chat, imagem e vídeo no marketplace da APIMart e experimente rapidamente as capacidades dos modelos com uma API unificada.
