APIMart
APIMart

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.

Tutorial

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

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:

RequisitoDetalhes
NavegadorQualquer navegador moderno como Chrome, Firefox ou Edge
InternetConexão estável para chamadas de API e download de vídeos
ArmazenamentoEspaço suficiente para salvar arquivos .mp4 (links de download expiram após 24 horas)
FerramentasQualquer 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

APIMart
Wan 2.7 Video Modes Compared: Inputs, Use Cases & Pricing

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_extend para 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:

ModoEntradaIdeal Para
Texto-para-VídeoApenas prompt de textoGerar novas cenas do zero
Imagem-para-Vídeo (Primeiro Quadro)1 imagem em image_urlsAnimar uma foto ou ilustração
Primeiro e Último Quadro2 imagens em image_urlsControlar início e fim de um plano
Continuação de VídeoClipe existente em video_urlsEstender uma sequência de vídeo
Edição de VídeoVídeo fonte + instruções de ediçãoReestilizar 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:

  1. 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_extend para adicionar detalhes cinematográficos automaticamente.
  2. 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.
  3. Defina os Parâmetros Principais:
    Ajuste estas configurações para resultados ideais:

    ParâmetroValor RecomendadoObservações
    resolution720PUse 1080P apenas 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 negativoSalve 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:

  1. 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
    }
    
  2. Receba um task_id: Você receberá um task_id para acompanhar o progresso.

  3. 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 seed de 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:

ProblemaCausa ProvávelSolução
Requisição falha completamenteIncompatibilidade de regiãoCertifique-se de que sua chave de API e URL do endpoint são da mesma região [5]
Vídeo parece uma foto estáticaMovimento insuficiente no promptInclua verbos de ação como "vira a cabeça" ou direções de câmera como "dolly forward" [8]
Sujeito muda no meio do clipePrompt sobrecarregadoSimplifique para focar em um sujeito, uma ação e um local [8]
Erro 400 no envioConflito de parâmetrosEvite enviar audio_url junto com image_urls ou video_urls [3]
Não consigo acessar a URL do vídeoLink expiradoFaç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.

Pronto para testar?

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.

Modelos de chatModelos de imagemModelos de vídeo
Explorar marketplace