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
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:
- Produza ou selecione um quadro estático inicial para cada tomada.
- Redija o prompt da tomada descrevendo a ação do sujeito, o movimento de câmera e o ritmo.
- 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. - Recolha os clipes retornados em uma fila de revisão.
- 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.

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.

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.

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:
- 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.
- 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.
- Disciplina de câmera — a câmera executa o único movimento solicitado, ou fica vagando?
- Adequação do ritmo — a ação se completa dentro da duração, sem cauda desnecessária e sem corte no meio do movimento?
- Varredura de defeitos — verifique bordas, mãos, rostos, textos de fundo e qualquer área de detalhe fino.
- 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 →-
Guia de uso
Guia de introdução ao gpt-6.2-sol: limites de capacidade, integração via API e noções de precificação por token
Decisões de integração e pontos práticos para equipes de engenharia
-
Guia de uso
Guia de introdução ao gpt-6.2-astra: limites de capacidade do modelo de texto, pontos de integração e controle de custos
-
Guia de uso
Guia de introdução ao Tripo H3.1: três modos de entrada, parâmetros e como escolher o preço
Decisão de integração e controle de custos na geração 3D para desenvolvedores