HiAPI
Blogue

Guia de uso

Receita de prompt de keyframe para vídeo do flux-3-max, pronta para copiar e colar

Guia do desenvolvedor: como organizar descrições de keyframes e frases de movimento para obter curtas previsíveis

Nov 3, 2026
Cover art of overlapping translucent glass planes casting calm bands of cool blue across a pale field, evoking keyframes flowing into motion.
Uma receita de keyframe para vídeo do flux-3-max pronta para copiar e colar: um push-in em um telhado molhado pela chuva, com leve deriva natural e gradiente de cor neon.

O que o fluxo de trabalho de keyframe para vídeo espera do seu prompt

Antes de escrever o primeiro prompt, vale a pena entender a divisão de trabalho no fluxo de keyframe para vídeo.

Você fornece duas ou mais keyframes estáticas. Elas são as âncoras: definem o que existe, onde está no quadro e como a cena se parece em um momento específico. O modelo interpola entre elas. Seu prompt de texto é o briefing de movimento: ele diz ao modelo como ir de uma âncora à próxima — o que se move, em que direção, com que intensidade aproximada, e como a câmera se move.

Essa divisão tem uma consequência prática: o prompt não precisa redescrever o mundo inteiro. Tudo o que é claramente visível nas keyframes já está estabelecido. O prompt deve gastar tinta com aquilo que a imagem estática não consegue expressar — movimento, ritmo, intenção de câmera e qualquer mudança de estado entre as âncoras (uma porta se abre, o sujeito se vira, a luz muda).

Um modelo mental útil: se você entregasse duas keyframes a um editor humano sem nenhuma instrução, ele perguntaria "como vamos de A para B?" Seu prompt é a resposta a essa pergunta. Todo o resto — correção de cor, detalhes de figurino, design de cenário — resolve-se melhor melhorando as keyframes do que enfiando adjetivos no texto.

Mantenha esse enquadramento em mente no restante deste guia. Cada receita abaixo é construída sobre a mesma ideia: as keyframes ancoram, o texto orienta o movimento.

A anatomia da descrição de keyframe

Saídas estáveis começam com entradas estruturadas estáveis. Descreva cada keyframe em uma ordem fixa, para que, quando algo sair errado, você saiba exatamente qual linha verificar.

Use a seguinte ordem de quatro partes para cada keyframe:

1. Sujeito

Quem ou o que é o foco, e em que estado. Seja específico sobre quantidade e postura: "um único ciclista, ereto, mãos no guidão" é melhor que "uma pessoa andando de bicicleta".

2. Cena e ambiente

Onde o sujeito está e o contexto mínimo necessário para localizá-lo: "em uma rua de asfalto molhada, com prédios baixos ao fundo". Geralmente uma oração basta.

3. Enquadramento e posição da câmera

O plano e o ângulo dessa keyframe: "plano médio, ao nível dos olhos, sujeito ligeiramente à esquerda do quadro". Este é o nó para o qual o vídeo vai interpolar, então é importante.

4. Luz e atmosfera

Hora do dia, direção da luz, clima, névoa. "Luz de contraluz no fim da tarde, névoa suave" é mais acionável que uma sequência de cinco adjetivos de humor.

Algumas regras práticas:

  • Mantenha a mesma ordem em todas as keyframes. Se a keyframe A começa pelo sujeito e a keyframe B começa pela luz, a edição vira adivinhação.
  • Descreva apenas o que é visível. Histórias de fundo especulativas só adicionam ruído que o modelo não consegue usar.
  • Uma frase por parte. Se uma parte precisa de duas frases, provavelmente são duas ideias disputando o controle.
  • Reutilize vocabulário entre keyframes. Se em A é "plano médio", em B também se chama "plano médio", não "enquadramento de média distância".

Essa estrutura é deliberadamente entediante. Estrutura entediante é o que torna a parte interessante — o movimento — depurável.

Formulação de movimento de câmera e de sujeito

A formulação de câmera e movimento é onde a maioria dos prompts dá errado, geralmente por tentar fazer coisa demais em uma única frase.

A regra é: curto, intenção única, orações independentes.

Boa formulação de movimento nomeia um único movimento e o deixa acontecer:

  • "A câmera se aproxima lentamente."
  • "A câmera faz um travelling para a direita, mantendo o sujeito centralizado."
  • "Leve deriva de câmera na mão, sem zoom."
  • "O sujeito se vira para a câmera e para."

Formulação ruim empilha intenções e força o modelo a um meio-termo:

  • "A câmera se aproxima lentamente enquanto faz um pan para a esquerda e inclina levemente para cima, enquanto o sujeito caminha para frente e se vira, com um zoom sutil."

Essa frase contém cinco instruções. Nenhum curta consegue satisfazer todas de forma limpa, então você recebe uma média turva. Divida o trabalho: escolha o movimento que carrega o plano e deixe as keyframes cuidarem do resto.

Algumas convenções práticas que compensam:

  • Separe câmera e sujeito. "A câmera permanece estática. O sujeito caminha da esquerda para a direita." Duas orações, dois donos do movimento.
  • Use palavras de velocidade com intenção. "Lentamente", "suavemente", "rapidamente" são úteis. "Dramaticamente" e "cinematograficamente" não são palavras de velocidade — são desejos.
  • Nomeie o estado final quando importar. "Aproxime até o sujeito preencher o quadro" dá ao modelo um alvo.
  • Formulação negativa é fraca. Prefira "câmera estática" a "sem movimento de câmera".

Se você só memorizar uma coisa: uma oração, uma intenção. Quando o curta sair errado, a primeira coisa a verificar é se uma oração de movimento contém secretamente dois movimentos.

Modelo de receita para copiar e colar

Abaixo está um esqueleto genérico. Copie, preencha os espaços e mantenha os rótulos — eles são para você, não para o modelo, então pode removê-los antes de enviar se quiser.

[KEYFRAME A]
Subject: {{subject_a}}
Scene: {{scene_a}}
Framing: {{framing_a}}
Light: {{light_a}}

[KEYFRAME B]
Subject: {{subject_b}}
Scene: {{scene_b}}
Framing: {{framing_b}}
Light: {{light_b}}

[MOTION]
Camera: {{camera_move}}
Subject: {{subject_move}}
Pacing: {{pacing}}

Um exemplo preenchido, para um curta curto no estilo de produto:

[KEYFRAME A]
Subject: a single ceramic mug, handle facing right, steam rising
Scene: on a wooden desk, blurred window behind
Framing: close-up, slightly above eye level, mug centered
Light: soft morning side light from the left

[KEYFRAME B]
Subject: the same ceramic mug, steam thinner, handle facing right
Scene: same wooden desk, window still blurred
Framing: close-up, slightly above eye level, mug centered
Light: slightly warmer morning light from the left

[MOTION]
Camera: slow push in
Subject: steam drifts upward and fades
Pacing: steady, unhurried

Dois espaços exigem cuidado extra. {{camera_move}} deve ser um único movimento da sua lista curta. {{pacing}} define a energia de todo o curta — é o botão de ajuste mais barato quando o resultado parece rápido ou lento demais.

Mantenha uma pequena biblioteca desses modelos preenchidos. Alguns esqueletos bem testados e com espaços claros quase sempre superam prompts escritos à mão de forma descartável, porque as variáveis ficam isoladas e visíveis.

Variantes de receita para diferentes intenções de movimento

O modelo permanece o mesmo; só o bloco de movimento muda. Abaixo estão três variantes construídas sobre os mesmos blocos de keyframe, cada uma voltada para uma intenção diferente.

Variante 1: Revelação (a câmera faz o trabalho)

[MOTION]
Camera: slow push in from medium to close-up
Subject: holds pose, breathing only
Pacing: slow, even

Use quando o sujeito é a recompensa e você quer que o quadro se feche em torno dele. Minimize o movimento do sujeito para que o movimento da câmera seja claramente percebido.

Variante 2: Travessia (o sujeito faz o trabalho)

[MOTION]
Camera: static, locked off
Subject: walks left to right across frame, steady stride
Pacing: moderate, continuous

Use quando a keyframe descreve um caminho ou mudança de posição. A câmera travada torna a travessia legível; dois movimentos concorrentes a tornam turva.

Variante 3: Atmosfera (o ambiente faz o trabalho)

[MOTION]
Camera: very slow lateral drift
Subject: mostly still, slight sway
Pacing: slow, ambient

Para planos de estabelecimento e fundos, em que a luz, a névoa ou partículas carregam o curta. O sujeito ancora o quadro; o ambiente fornece a variação.

Note o que não muda: a descrição das keyframes. Esse é o sentido da estrutura. Uma vez que suas âncoras estejam estáveis, trocar a intenção de movimento é uma edição de duas linhas em vez de uma reescrita — o que torna o teste A/B de curtas na mesma cena realmente viável.

Modos de falha e como depurar curtas que saíram errado

Quando o curta sair errado, não se apresse em reescrever o prompt. Sair errado é informação. Mude uma variável por vez, execute novamente e só então mexa em qualquer outra coisa.

Abaixo estão os modos de falha comuns e a correção de variável única para cada um.

O curta parece confuso ou "mediado"

Causa: duas ou mais intenções de movimento em uma única oração. Correção: divida o bloco de movimento em linhas separadas e remova tudo exceto o movimento dominante.

O sujeito se deforma ou perde a identidade

Causa: o texto descreve demais o sujeito, competindo com as keyframes. Correção: reduza a linha do sujeito, em ambas as keyframes, a quantidade, postura e um detalhe decisivo. Deixe as âncoras carregarem a identidade.

Você pediu para a câmera não se mover, e ela se moveu

Causa: há movimento implícito em outro lugar, ou a palavra de ritmo sugere energia. Correção: escreva "a câmera permanece estática" como oração independente e suavize as palavras de ritmo.

O movimento é rápido ou lento demais

Causa: ritmo não especificado ou autocontraditório. Correção: mude apenas {{pacing}}. Execute novamente. Não ajuste a oração da câmera na mesma rodada.

O curta ignora a segunda keyframe

Causa: a keyframe B se afasta de A em dimensões demais ao mesmo tempo. Correção: compare as duas descrições linha a linha e reduza a diferença na linha menos importante. Altere uma linha, execute novamente, repita.

A disciplina é simples: uma variável por iteração e um registro breve do que você mudou. Depois de três ou quatro rodadas, você geralmente encontra a linha culpada — e aprende algo reutilizável sobre a própria receita.

Controle de versão e compartilhamento de receitas na equipe

Quando uma receita funciona, ela deixa de ser um prompt e se torna um ativo do projeto. Trate-a como ativo.

Um sistema leve já basta:

  • Armazene receitas no repositório. Um diretório prompts/, um arquivo por receita, junto com o código que as usa. Receitas são versionadas junto com o código de requisição.
  • Nomeie por intenção, não por cena. reveal-product-closeup.md é localizável; prompt-final-v3-really.md não é.
  • Separe o esqueleto do preenchimento. Guarde o modelo uma vez e os exemplos preenchidos como pequenos diffs em relação a ele. Assim os revisores veem exatamente quais espaços mudaram.
  • Registre o que mudou e o que aconteceu. Um changelog de duas linhas por receita — variável alterada, efeito observado — vale mais que um parágrafo de prosa.
  • Revise receitas como código. Um colega deve conseguir ler o diff e prever o curta. Se não conseguir, a oração de movimento está fazendo coisa demais.
  • Aposente com intenção. Quando uma receita for substituída, marque-a e aponte para a substituta em vez de excluí-la, para que curtas antigos continuem reproduzíveis.

Essa é a parte ingrata do fluxo de trabalho, e é exatamente o que distingue equipes que entregam curtas consistentes daquelas que rediscutem o prompt a cada tarefa. Quando estiver pronto para executar essas receitas por uma interface unificada, conecte sua requisição de ponta a ponta e comece pela página do modelo de keyframe para vídeo flux-3-max.

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