Blogue

Guia de uso

Fluxo de trabalho de vídeo curto com imagem para vídeo do Wan2.7 via API HiAPI

Guia para desenvolvedores: seleção do primeiro quadro, prompts de câmera e ritmo, proporção de aspecto, duração e geração em lote

Nov 9, 2026
Imagem de capa geométrica plana em fundo bege com faixas horizontais escalonadas em vermelho-terroso diminuindo da esquerda para a direita, para o guia de fluxo de trabalho de vídeo Wan2.7.
Nesta página

Por que imagem para vídeo se adequa à produção de vídeos curtos

Vídeo curto é um negócio movido por volume. Um único clipe raramente é a entrega final; a entrega real é uma sequência de clipes que compartilham a mesma aparência, o mesmo ritmo e a mesma frequência de publicação. Essa exigência molda a escolha de ferramentas mais do que qualquer métrica isolada de qualidade de saída.

Imagem para vídeo se encaixa muito bem nisso porque transforma o quadro estático no principal sinal de controle. Em vez de descrever a cena inteira em texto e torcer para que o modelo caia exatamente na composição que você imaginou, você entrega ao modelo um quadro já aprovado: o sujeito está onde você o posicionou, o enquadramento é o que você desenhou, a luz incide como você a montou. A etapa de geração passa a girar em torno do movimento — como o sujeito se move, como a câmera se move, quão rápido a câmera respira — em vez de criar uma cena do zero.

Essa divisão de trabalho importa para equipes. O quadro estático pode ser produzido, revisado e aprovado por quem tem talento para composição, usando qualquer pipeline que você já tenha. O movimento é um problema menor e mais fácil de testar. Quando um clipe sai errado, você geralmente consegue dizer se o problema está no quadro ou no prompt, e essa é exatamente a forma de depuração dicotômica que você quer ao produzir dezenas de clipes por semana.

O pipeline de ponta a ponta na HiAPI é deliberadamente entediante:

  1. Produza ou selecione um quadro estático inicial para cada tomada.
  2. Redija o prompt da tomada descrevendo a ação do sujeito, o movimento de câmera e o ritmo.
  3. Envie o quadro estático e o prompt, junto com proporção de aspecto e duração fixas, para a rota wan2.7-video/image-to-video.
  4. Recolha os clipes retornados em uma fila de revisão.
  5. Aceite, reformule o prompt ou reenquadre, e então publique.

O guia inteiro trata de tornar cada uma dessas etapas reproduzível, porque o valor de um pipeline de vídeo curto não está em um clipe excepcional — está em conseguir rodar o mesmo processo amanhã com novos quadros e obter resultados comparáveis.

O quadro estático como unidade de trabalho

Trate o quadro estático como o artefato que você versiona. Na prática, isso significa nomear quadros de forma determinística e manter os quadros aprovados junto com os prompts usados com eles. Se depois você quiser tentar variantes do mesmo plano, mude apenas uma variável por vez: o prompt ou o quadro, nunca os dois.

O que o modelo decide por você e o que não decide

Proporção de aspecto e duração são decisões suas, não propriedades que surgem do prompt. Fixe-as desde cedo. Tudo a jusante — como você enquadra o quadro estático, como formula o ritmo, como corta o clipe para a plataforma — assume que esses dois valores já estão fixos.

De um único quadro estático ao clipe publicável: cada estágio avança ao longo da mesma estrutura de faixas.

Selecionar o primeiro quadro

O primeiro quadro carrega a maior parte do trabalho. Se o primeiro quadro estiver errado, nenhum ajuste de prompt salvará totalmente o clipe, e você gastará muitas rodadas de iteração perseguindo um problema que na verdade está no quadro estático. Antes de gastar qualquer geração, filtre os candidatos com uma lista curta e explícita.

Composição e enquadramento do sujeito

O quadro que você escolher deve ser composto para a proporção de aspecto que você vai entregar, não apenas recortado para ela. Se o sujeito estiver próximo da borda no quadro estático, espere que o modelo tenha pouco espaço para mover a câmera sem empurrar o sujeito para fora do quadro. Deixe espaço para o movimento acontecer: espaço de condução na direção do pan esperado, espaço acima de um sujeito que pode subir, elementos de primeiro plano capazes de gerar paralaxe.

Verifique o recorte na proporção de entrega, não na proporção de origem. Um quadro que parece equilibrado como quadrado pode perder o sujeito quando comprimido em um quadro vertical alto.

Espaço de cabeça e consistência de enquadramento

Se um lote de clipes for editado junto ou publicado em sequência, mantenha o espaço de cabeça consistente entre os quadros. Espaço de cabeça inconsistente é lido como edição descuidada, mesmo que cada clipe isolado esteja bom. Defina uma convenção — por exemplo, uma distância fixa entre o topo da cabeça do sujeito e a borda superior do quadro — e aplique-a a cada quadro estático do grupo.

Direção da luz e estabilidade das sombras

A iluminação determina quão verossímil o movimento parece. Luz forte e direcional com sombras nítidas dá ao modelo uma estrutura na qual se apoiar; luz plana e sem sombras costuma produzir movimento que parece deslizar em vez de se mover. Prefira quadros com direção de luz inequívoca e evite quadros estáticos em que as sombras possam cair em duas direções — essa ambiguidade costuma se manifestar como cintilação.

Estaticidade que conduz ao movimento

Um bom primeiro quadro sugere o que acontece a seguir. Um sujeito no meio de uma ação, um olhar voltado para fora do quadro, um corpo inclinado na direção de um espaço aberto — tudo isso dá ao modelo uma direção natural de continuidade. Retratos perfeitamente simétricos, de frente para a câmera e parados são os mais difíceis de animar naturalmente, porque não têm direção implícita.

Limpeza do quadro

Antes de gerar, inspecione o quadro estático em resolução total em busca de defeitos: arrasto nas bordas, mãos inconsistentes, texturas duplicadas, texto que se distorce de forma evidente assim que começa a se mover. Pequenos defeitos no quadro estático se tornam defeitos óbvios no clipe. Corrigir ou regerar o quadro quase sempre é mais barato do que regerar o vídeo.

Comparação de três primeiros quadros candidatos em enquadramento do sujeito, espaço de cabeça e direção da luz.

Redigir prompts de câmera e ritmo

O erro de prompt mais comum em imagem para vídeo é escrever o prompt como uma descrição de cena. A cena já está definida — é o quadro. O que o modelo precisa de você são instruções de câmera: o que se move, como se move, quão rápido.

Organize o prompt em três orações

Prompts que produzem clipes utilizáveis de forma consistente costumam cobrir três coisas em ordem:

  • Ação do sujeito — o que o sujeito faz, com descrição física concreta.
  • Movimento de câmera — o que a câmera faz, como um único movimento limpo.
  • Ritmo — a velocidade com que a ação se desenrola ao longo do clipe.

Por exemplo, em vez de descrever uma pessoa em uma sala, descreva o sujeito virando a cabeça para a janela, a câmera avançando lentamente, e a ação se desenrolando gradualmente ao longo de toda a duração. Cada oração corresponde a algo que o modelo pode executar.

Mantenha um único movimento de câmera

Use um movimento por plano. Avanço, pan ou deriva manual — escolha um. Prompts que pedem avanço, órbita e zoom ao mesmo tempo costumam produzir movimento confuso e indefinido. Se um plano precisa de dois movimentos, são dois planos.

Siga o ritmo da plataforma, não o do modelo

O público de vídeo curto desliza rápido. Um clipe que passa a maior parte da duração estabelecendo uma cena estática perde o espectador antes que algo aconteça. Escreva o ritmo de forma explícita: antecipe um pouco de movimento nos primeiros instantes e então estabilize a câmera na ação principal. Palavras que comunicam velocidade — gradualmente, vivamente, continuamente, estabilizando — são mais úteis do que uma longa lista de adjetivos.

Descreva movimento, não emoção

Palavras emocionais são baratas e em grande parte ignoradas. Descrições físicas não são. Prefira afirmações observáveis sobre corpos, objetos e câmera a traços abstratos. Se você quer uma aparência emocional específica, obtenha-a por meio da ação e do ritmo, não de palavras como "cinematográfico".

Versione prompts como se fossem código

Guarde cada prompt junto com o identificador do quadro, a proporção de aspecto e a duração em um repositório de código ou banco de dados. Quando um clipe ficar bom, você vai querer saber qual combinação o produziu, para depois repetir essa combinação em um lote inteiro de quadros semelhantes.

Definir proporção de aspecto e duração

Proporção de aspecto e duração são os dois parâmetros com maior probabilidade de comprometer silenciosamente o fluxo de trabalho, porque nenhum dos dois aparece no prompt e ambos mudam o que conta como bom resultado. Decida-os uma vez para cada formato de saída e trate-os como constantes.

Escolher a proporção de aspecto

Escolha a proporção que sua plataforma de destino realmente exibe e componha seu quadro estático para ela. A consequência prática: você não deve reutilizar o mesmo quadro entre vertical e horizontal sem recompor — um recorte que funciona em formato alto raramente funciona em formato largo. Se precisar dos dois, mantenha dois conjuntos de quadros estáticos derivados da mesma filmagem, cada um composto para sua própria proporção.

Depois de decidir, registre essa proporção junto com cada requisição. Proporções misturadas em um lote concluído geralmente significam que alguém mudou o padrão, não que tomou uma decisão.

Escolher a duração

Clipes de vídeo curto são curtos. Planeje uma duração compatível com o formato: longa o suficiente para completar uma única ação clara, curta o suficiente para não haver nada ocioso. Como a HiAPI cobra imagem para vídeo pela duração de saída, clipes longos demais custam mais e são piores de revisar — o público raramente chega ao fim de um clipe que já não tem mais nada a dizer.

Escreva o prompt para preencher a duração escolhida. Uma ação descrita que dura mais que o clipe produz um corte abrupto no meio do movimento; uma ação que termina em uma fração da duração deixa um vazio no final. Combine deliberadamente a formulação de ritmo com o comprimento.

Fixe ambos antes de escalar

Esta é a regra de processo mais importante deste guia. O ajuste de prompts só faz sentido dentro de uma proporção de aspecto e duração fixas, porque ambas mudam a forma como o movimento é percebido. Se você ajustar um prompt em uma duração e depois encurtar a saída, todo prompt que você aprovou se torna um palpite não testado. Trave o par de parâmetros, ajuste para ele e mude-o apenas como um evento deliberado de reajuste.

Parâmetros que vale registrar a cada execução

Mantenha um pequeno registro para cada lote: proporção de aspecto, duração, rota do modelo, identificador do grupo de quadros, versão do prompt. Esse registro de quatro campos costuma ser suficiente para reconstruir, meses depois, por que um clipe ficou como ficou, sem precisar vasculhar logs.

Gerar em lote na HiAPI

Depois que o grupo de quadros e o padrão de prompts estiverem aprovados, a geração é mecânica. O objetivo é um pequeno script que expanda as requisições e colete os resultados de forma determinística, para que você possa executá-lo conforme o cronograma em vez de manualmente.

Credenciais e configuração

Mantenha as credenciais da API em variáveis de ambiente, nunca no script nem no repositório. Leia o endpoint e a rota do modelo a partir da configuração, para que depois você possa apontar o mesmo script para uma rota diferente sem alterar o código.

export HIAPI_API_KEY="your-key-here"

Uma requisição executável

A rota deste fluxo de trabalho é wan2.7-video/image-to-video. A requisição mínima contém o primeiro quadro, o prompt da câmera, a proporção de aspecto e a duração:

curl -X POST "https://api.hiapi.ai/v1/video/generations" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-video/image-to-video",
    "image": "https://your-cdn.example/frames/shot-014.png",
    "prompt": "Subject turns toward the window; slow push-in; gradual motion settling over the clip.",
    "aspect_ratio": "9:16",
    "duration": 5
  }'

Antes de repetir qualquer coisa em loop, execute uma vez com um quadro sabidamente bom. Uma única requisição bem-sucedida confirma suas credenciais, o nome da rota e a estrutura do payload.

Percorrer um conjunto de quadros

Geração em lote é a mesma requisição repetida, apenas com image diferentes e o prompt correspondente. Organize as entradas como uma lista de registros, em que cada registro carrega a URL do quadro, seu prompt e um nome de saída sob seu controle. Itere, envie e registre os identificadores retornados no registro de entrada.

Duas regras práticas para o loop:

  • Limite a concorrência. Disparar todas as requisições de uma vez é a forma mais rápida de bater no limite de taxa e de não saber qual resposta pertence a qual entrada. Um pool de trabalho moderado com repetição de tentativas é mais confiável do que uma rajada.
  • Registre requisição e resultado juntos. Para cada geração, persista a URL do quadro, o prompt, a proporção de aspecto, a duração e a referência do clipe retornado. Sem isso, você não consegue reproduzir um clipe bom nem explicar um clipe ruim.

Coletar as saídas

Baixe os clipes em uma estrutura de pastas determinística, indexada por identificador de quadro e versão de prompt, e então entregue a pasta para revisão. Manter o esquema de nomes estável faz com que sua etapa de revisão seja apenas listar um diretório, e não um trabalho de conciliação.

Idempotência em reexecuções

Atribua um hash estável a cada par quadro-prompt e ignore os pares já gerados, a menos que você esteja deliberadamente regerando. Regerar o lote inteiro para preencher três lacunas é a forma mais comum de as equipes desperdiçarem cota em pipelines de imagem para vídeo.

Uma credencial e uma rota de modelo transformam uma pilha de primeiros quadros em requisições paralelas em leque, com os clipes coletados na mesma pasta de saída.

Revisar e iterar as saídas

A revisão é uma etapa de produção, não uma formalidade. O ponto é classificar rapidamente cada clipe em um dos três resultados — aceitar, reformular o prompt ou reenquadrar — para que o lote inteiro continue avançando.

Uma lista de verificação curta de revisão

Faça cada clipe retornado passar pelas mesmas verificações, em ordem:

  1. Fidelidade ao primeiro quadro — o instante inicial corresponde ao quadro estático aprovado? Se houver deriva imediata, o problema geralmente está no quadro, não no prompt.
  2. Verossimilhança do movimento — o sujeito se move como corpos e objetos realmente se movem? Atenção a deslizamento, deformação de membros e objetos que mudam de forma.
  3. Disciplina de câmera — a câmera executa o único movimento solicitado, ou fica vagando?
  4. Adequação do ritmo — a ação se completa dentro da duração, sem cauda desnecessária e sem corte no meio do movimento?
  5. Varredura de defeitos — verifique bordas, mãos, rostos, textos de fundo e qualquer área de detalhe fino.
  6. Verificação de formato — a proporção de aspecto está correta e o sujeito está dentro da margem segura das sobreposições de UI da plataforma?

Decisão de triagem

  • Aceitar se o clipe passar nas seis verificações, ou falhar apenas em aspectos invisíveis no tamanho de entrega.
  • Reformular o prompt se o quadro estiver bom, mas o movimento, a câmera ou o ritmo estiverem errados. Altere uma oração do prompt e gere novamente.
  • Reenquadrar se o defeito de movimento puder ser rastreado até uma ambiguidade no quadro estático — direção de luz incerta, recorte estranho ou sujeito sem movimento implícito.

Mude apenas uma variável por iteração. Alterar quadro e prompt ao mesmo tempo não diz qual correção funcionou.

Revisão barata vale mais que o plano perfeito

Para produção em massa de vídeos curtos, uma revisão rápida de aprovado/reprovado em muitos clipes supera o polimento de um único clipe com muitas regerações. Revise no tamanho em que o público realmente vê o clipe, não em resolução total, e amplie apenas os clipes que você está prestes a aceitar. Isso mantém a etapa de revisão proporcional ao tamanho do lote, e não à sua ansiedade.

Retroalimentar os achados

Registre continuamente quais padrões de prompt e qualidades de quadro se correlacionam com a taxa de aceitação. Depois de alguns lotes, isso se torna um estilo interno — um pequeno conjunto de orações de prompt e regras de enquadramento que produzem de forma consistente clipes que os revisores aprovam sem longa discussão.

Armadilhas a evitar

A maioria dos projetos de imagem para vídeo que travam em produção falha por questões de processo, não de modelo. A seguir estão as que se repetem.

Ajustar prompts contra um alvo móvel

Mudar duração ou proporção de aspecto no meio do ajuste invalida toda comparação que você fez. Fixe ambos primeiro, depois ajuste. Se as partes interessadas pedirem outro formato, trate-o como um novo ciclo de ajuste com seus próprios prompts aprovados, e não como um pequeno ajuste de parâmetro.

Tratar o quadro estático como pensamento posterior

Equipes que geram um quadro rapidamente e depois gastam toda a energia no prompt logo batem no teto. O quadro é o sinal de controle. Reserve tempo real de revisão para os quadros estáticos e rejeite quadros fracos antes que entrem na geração.

Usar descrição de cena em vez de instrução de câmera

Prompts cheios de emoção e história de fundo, mas sem ação física, produzem clipes bonitos em que nada acontece. Todo prompt deve indicar o que se move e quão rápido.

Concorrência ilimitada e logs ausentes

Disparar requisições em rajada e descartar os identificadores de resposta torna o lote irrecuperável. Registre entradas e saídas juntas, limite o número de threads e torne as reexecuções idempotentes.

Sem registro de aprovação

Se você não consegue apontar o quadro, o prompt, a proporção e a duração exatos que produziram um clipe aceito, não consegue repeti-lo. Esse custo aparece na primeira vez que você precisa escalar uma série e percebe que o melhor clipe não pode ser reproduzido.

Geração excessiva para preencher pequenas lacunas

Regerar o lote inteiro porque três clipes falharam desperdiça tempo e orçamento. Acompanhe o estado de cada item e regenere apenas as partes que faltam.

Ignorar as áreas seguras da plataforma

Um clipe tecnicamente correto, mas com o sujeito sob a sobreposição de interface da plataforma, é lido como defeituoso. Componha o quadro estático usando a mesma margem segura que você usa em qualquer outro ativo entregue.

Nada disso é exótico. É apenas a disciplina de rotina de um pipeline de produção, aplicada a um modelo que recompensa essa disciplina.

Comece com um quadro aprovado e um prompt, rode de ponta a ponta na rota wan2.7-video/image-to-video e só então expanda o loop para um lote completo.

Artigos relacionados

Ver todos os artigos →

Comece a criar com artefactos de IA persistentes

Obtenha a sua chave de API e chame modelos de imagem, vídeo e áudio através de uma única API baseada em tasks.

Ler a documentação da API