Guia de uso
Receitas de prompts de texto para vídeo do Wan 2.7 para desenvolvedores
Estruturas de prompt prontas para copiar, cobrindo segmentação de planos, movimento de câmera, ritmo e prompts negativos
Nesta página
Por que a estrutura do prompt importa mais que o comprimento
A maioria dos resultados decepcionantes de renderização de texto para vídeo não acontece porque o prompt é curto demais, mas porque o prompt carece de estrutura. Quando você junta sujeito, ação, câmera, iluminação e ritmo em um único parágrafo fluido, o modelo só pode adivinhar qual frase é a instrução principal e qual é um modificador. O resultado é um clipe aparentemente razoável mas imprevisível: bom para uma demonstração, inutilizável para produção em lote.
Prompts estruturados são completamente diferentes. Eles dividem o clipe em vários pontos de atenção explícitos e rotulados, permitindo que cada parte seja interpretada de forma independente. Isso traz três benefícios práticos para desenvolvedores:
- Previsibilidade. Quando a instrução de câmera ocupa sua própria linha, alterá-la muda apenas a câmera — não a roupa do sujeito, a iluminação ou o ritmo.
- Comparabilidade. Dois prompts estruturados podem ser comparados linha a linha; dois parágrafos densos geralmente não.
- Reutilização. Um esqueleto com slots nomeados pode ser preenchido programaticamente; um parágrafo escrito de uma vez só pode ser apenas copiado e colado.
Comprimento não é o objetivo. Um prompt bem estruturado costuma ser mais curto que o parágrafo que ele substitui, porque cada frase vale a pena. Em vez de tratá-lo como prosa, trate-o como um pequeno arquivo de configuração: alguns campos, cada um com um contrato claro.
Regra prática
Se você aponta para uma linha e não consegue dizer o que ela controla, exclua-a ou mova-a para um slot. Adjetivos que não mapeiam para slots ("deslumbrante", "impressionante", "obra-prima") geralmente só adicionam ruído em vez de direção. O que realmente funciona são substantivos e verbos concretos colocados no slot correto. O restante deste guia gira em torno dessa ideia.

O esqueleto de prompt com cinco slots
Cada clipe começa com o mesmo esqueleto. Cinco slots cobrem a grande maioria das variações controláveis; a ordem importa menos que a consistência.
SUBJECT: <quem ou o quê, uma frase, substantivo concreto>
ACTION: <o que acontece no clipe, no presente>
CAMERA: <tamanho do plano + movimento + enquadramento do sujeito>
LIGHTING: <hora do dia, fonte de luz, contraste, temperatura de cor>
PACING: <sensação de duração, velocidade do movimento, mudança ao final>
O que colocar em cada slot
SUBJECT (Sujeito) ancora a identidade. Mantenha apenas o essencial: tipo de entidade, características marcantes, vestuário ou material. Não conte uma história aqui — isso é função do ACTION.
ACTION (Ação) descreve um único compasso de ação contínua. "Ela se vira da janela e pega a xícara" é um compasso. "Ela se vira, pega a xícara, caminha até a porta e sai" são quatro compassos disputando um clipe curto.
CAMERA (Câmera) combina tamanho do plano e movimento, porque o modelo os lê como uma única decisão. "Plano médio, avanço lento" é coerente. "Close-up" e "plano geral de estabelecimento" no mesmo prompt não são.
LIGHTING (Iluminação) dá à renderização uma âncora física: luz de janela, dia nublado, sol forte do meio-dia, luminárias práticas quentes. Ela controla o clima sutilmente, mas deve ser declarada como fato, não como emoção.
PACING (Ritmo) diz ao modelo como o clipe deve terminar em comparação com o início. "Lento, contínuo, terminando quase estático" é uma instrução de ritmo. "Dinâmico" sozinho não é.
Exemplo preenchido
O esqueleto preenchido fica assim:
SUBJECT: uma caneca de cerâmica sobre uma mesa de madeira, vapor subindo
ACTION: o vapor se enrola para cima e se dissipa
CAMERA: close-up, câmera fixa, ângulo ligeiramente baixo
LIGHTING: luz suave de janela da manhã vindo da esquerda, sombras frias
PACING: lento e contínuo, quase estático no último segundo
Mantenha cada slot com uma a duas linhas. Se um slot exigir um parágrafo inteiro, o clipe provavelmente está tentando fazer coisas demais e deve ser dividido em dois.

Escrevendo dicas de movimento de câmera e ritmo
A linguagem de câmera é onde a qualidade do prompt se diferencia mais rapidamente. Verbos de movimento vagos produzem movimento vago. Termos emprestados da cinematografia real traduzem de forma mais confiável, porque descrevem mudanças geométricas concretas.
Vocabulário de movimento testado pelo tempo
- Pan (panorâmica) — a câmera gira horizontalmente de um ponto fixo. Use com direção: "panorâmica lenta para a esquerda".
- Tilt (inclinação) — gira para cima ou para baixo de um ponto fixo.
- Dolly / push in / pull out (dolly / avanço / recuo) — a câmera se aproxima ou se afasta fisicamente do sujeito.
- Tracking (acompanhamento) — a câmera se move junto com um sujeito em movimento.
- Zoom (zoom) — mudança de distância focal com a posição da câmera fixa. Diferente de dolly; escolha um, não use os dois ao mesmo tempo.
- Orbit / arc (órbita / arco) — a câmera circula ao redor do sujeito.
- Locked-off (câmera fixa) — completamente imóvel. Subestimado, mas extremamente confiável.
Sempre combine eixo com velocidade e relação com o sujeito: "avanço lento, sujeito centralizado", em vez de apenas "tomada dramática". Um movimento por clipe é o padrão seguro. Dois movimentos podem funcionar quando compartilham o mesmo eixo (avanço lento com leve inclinação para cima); movimentos em direções opostas geralmente entram em conflito.
Dicas de ritmo
Ritmo diz respeito à forma do clipe ao longo do tempo, não ao seu comprimento literal. Frases úteis:
- "movimento lento e contínuo"
- "o movimento chega ao repouso no final"
- "velocidade constante, sem aceleração"
- "apenas uma deriva sutil"
Evite empilhar palavras de intensidade. "Rápido, dinâmico, energético, cinematográfico" não dá ao modelo nenhuma forma a seguir. "Caminhada constante, parando no centro do quadro" dá forma.
Combinando câmera e ritmo
Câmera e ritmo devem ser consistentes entre si. Um close-up com câmera fixa combinado com "movimento rápido no quadro" é contraditório. Um avanço lento combinado com "sujeito quase imóvel, respiração sutil" é coerente. Na dúvida, reduza a amplitude do movimento e aumente a especificidade — um plano estático descrito com precisão supera um plano dinâmico descrito de forma vaga.

Construindo listas de prompts negativos
Prompts negativos são uma lista pequena e estável do que você nunca quer ver no lote. Trate-a como infraestrutura compartilhada, não como improvisação por prompt.
A lista central curta
A lista central se mantém compacta e focada em defeitos:
embaçado, baixa resolução, artefatos de jpeg, marca d'água, sobreposição de texto,
mãos distorcidas, dedos extras, rostos deformados, membros duplicados,
cintilação, rasgo de quadro, cortes abruptos, supersaturado, altas luzes estouradas
Cerca de uma dúzia de itens cobre a maioria das falhas de primeira tentativa. Não adicione impulsivamente sempre que uma renderização sair ruim — listas negativas excessivamente longas suprimem detalhes legítimos junto com os defeitos.
Adições em camadas por projeto
As extensões devem ser opcionais e restritas ao escopo do projeto, não à lista central:
core_negatives + ["logo visível", "cores da marca"] # tomadas de produto
core_negatives + ["multidão", "pessoas ao fundo"] # sujeitos isolados
core_negatives + ["chuva", "superfícies molhadas"] # cenas internas
Assim a linha de base compartilhada permanece estável enquanto cada projeto pode apertar suas próprias restrições. Duas regras mantêm a lista saudável: adicione um termo somente depois que o mesmo defeito aparecer duas vezes; remova o termo quando você não conseguir mais reproduzir o problema que ele corrigia.
O que não colocar
Não negue palavras de estilo que você realmente quer (escrever "sem cinematográfico" enquanto pede uma tomada cinematográfica), nem negue movimento em um clipe que precisa de movimento. Prompts negativos servem para evitar defeitos; são ruins para apontar para uma aparência. Para isso, use slots positivos.
Adaptando receitas para padrões de requisição de API
Depois que uma receita funciona, pare de colá-la manualmente. Salve-a como um template com slots nomeados e preencha esses slots a partir de parâmetros. O template se torna a unidade que você itera, revisa e reutiliza.
O objeto de template
{
"template_id": "desk-product-closeup",
"version": "3",
"slots": {
"subject": "uma caneca de cerâmica sobre uma mesa de madeira, vapor subindo",
"action": "{{action}}",
"camera": "close-up, câmera fixa, ângulo ligeiramente baixo",
"lighting": "{{lighting}}",
"pacing": "lento e contínuo, quase estático no último segundo"
},
"negative": "core_negatives"
}
Seu código de construção de requisição então renderiza os slots na string de prompt final e envia pelo endpoint de texto para vídeo no HiAPI.ai. O nome do modelo e o endpoint permanecem fixos no mesmo lugar; apenas os valores dos slots mudam.
Montagem do prompt renderizado
PROMPT = """SUBJECT: {subject}
ACTION: {action}
CAMERA: {camera}
LIGHTING: {lighting}
PACING: {pacing}"""
def build_prompt(slots: dict) -> str:
return PROMPT.format(**slots).strip()
Duas convenções práticas compensam imediatamente. Primeiro, mantenha os valores dos slots curtos — um slot com mais de duas linhas geralmente são dois slots. Segundo, congele a string do esqueleto e mude apenas os valores; alterar o esqueleto entre execuções significa que você nunca mais poderá comparar resultados. Se um slot precisar de mudança estrutural, isso é uma nova versão do template, não uma edição no local.
Versionamento de prompts e comparação de saídas
Mudar um prompt custa pouco; mudar às cegas custa caro. Gerencie-os como código: registre qual prompt produziu cada renderização e tenha uma comparação antes/depois visível para cada alteração de prompt.
O que registrar a cada renderização
- id e versão do template
- a string de prompt renderizada exata, não apenas os valores dos slots
- versão da lista negativa
- arquivo de saída ou id da tarefa
- uma linha dizendo o que você pretendia mudar
Com esse conjunto de registros, você pode responder à pergunta que realmente importa depois de um lote ruim: foi essa mudança que causou a regressão, ou o problema já existia?
Comparando resultados de renderização
Revise em pares, não isoladamente. Escolha um pequeno conjunto fixo de valores de slots representativos como conjunto de fumaça — um plano estático, um plano em movimento, um close-up, um plano geral — e renderize-os novamente sempre que a versão do template for atualizada. Compare resultados antigos e novos lado a lado com as mesmas entradas. Se nada mudou no conjunto de fumaça, a mudança provavelmente é segura. Se melhorou um caso e quebrou outro, você encontrou uma fronteira e pode decidir conscientemente.
Disciplina de rollback
Nunca exclua versões antigas de templates. Marque-as como substituídas e mantenha-as endereçáveis. Quando outro tipo de cena regredir duas semanas depois, a versão anterior é seu ponto de referência mais rápido. O mesmo vale para listas negativas: versione-as junto com os templates, porque alterações em itens negativos podem afetar a saída tanto quanto os itens positivos.
Iterando sem quebrar prompts que funcionam
A parte mais difícil do trabalho com prompts não é obter uma boa receita — é melhorá-la sem perder o que já foi conquistado. O modo de falha típico é mudar cinco coisas de uma vez, gostar do resultado e não ter ideia de qual mudança fez a diferença.
Mude uma variável por vez
Escolha um slot ou uma palavra negativa. Mantenha todo o resto fixo, incluindo valores de slots, string do template e entradas de versão. Renderize o conjunto de fumaça. Tome uma decisão. Depois passe para a próxima mudança.
Quando o clipe está próximo, mas não ideal, a ordem prática de processamento:
- Primeiro ajuste o ritmo. Movimento mais suave ou mais lento corrige mais problemas perceptivos do que qualquer outra edição isolada, e raramente quebra outras partes da renderização.
- Depois ajuste a câmera. Ajuste apenas uma propriedade por vez: tamanho do plano ou velocidade do movimento.
- Terceiro, ajuste a iluminação. Ajuste finamente direção e contraste.
- Por último, ajuste sujeito e ação. Eles interferem mais e têm maior probabilidade de invalidar os ajustes anteriores.
Saiba quando parar
Nem todo defeito é um defeito do prompt. Se três edições direcionadas de ritmo e câmera não mudarem o resultado, a receita pode precisar de um novo compasso — divida o clipe em vez de continuar ajustando. Da mesma forma, se uma renderização está boa exceto por um defeito persistente, adicione exatamente um termo negativo em vez de reestruturar o prompt.
Mantenha o ciclo curto: uma edição, uma renderização do conjunto de fumaça, uma decisão. Depois de algumas rodadas, essa disciplina produz uma biblioteca de prompts em que você realmente confia — e templates que ainda renderizarão os mesmos resultados no mês que vem.
Pronto para executar essas receitas? O modelo de texto para vídeo Wan 2.7 no HiAPI.ai oferece um único endpoint unificado, e seus templates e rótulos de versão podem se conectar diretamente ao seu pipeline existente.
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