Guia de uso
Receitas de prompts do Flux-1 Kontext Max: prompts de edição prontos para copiar e colar que realmente funcionam
Padrões de formulação de instruções que você pode colar no Kontext Max hoje mesmo, e como iterar quando a primeira edição não acerta o alvo
A essência das receitas de prompts do Kontext Max
Uma receita de prompt não é um texto descritivo — é um formato compacto de instrução que diz ao modelo exatamente o que mudar e o que preservar. Para o Flux-1 Kontext Max, toda receita confiável que usamos segue a mesma estrutura de quatro partes:
- Verbo — o tipo de operação: substituir, remover, recolorir, adicionar, estender, reestilizar.
- Alvo — a região ou objeto sobre o qual o verbo atua, nomeado com precisão ("a jaqueta vermelha usada pela pessoa à esquerda").
- Mudança desejada — o estado final, não o processo ("torne-a azul-marinho" em vez de "mude a cor").
- Cláusula de preservação — o que deve permanecer exatamente igual ("mantenha as mesmas dobras de tecido, iluminação e fundo").
Assim, uma receita fica mais ou menos assim: replace the jacket on the person at left with a navy wool coat; keep pose, lighting, and background unchanged.
O modelo mental essencial: o Kontext Max é um editor, não um gerador. Ele parte da sua imagem de entrada e aplica um diff. Quanto menor esse diff e mais precisas as fronteiras, mais previsível o resultado. Prompts que soam como descrições de geração de imagem ("um retrato melancólico de uma mulher em uma cidade à noite") dão ao modelo liberdade para regenerar tudo — e ele faz exatamente isso.
A cláusula de preservação é a parte que a maioria das pessoas pula e a que mais ajuda. Sem ela, o modelo trata o restante da imagem como livre para mudanças. Com ela, você basicamente desenha uma máscara em linguagem natural — o que é útil, pois você nunca precisa construir uma máscara manualmente.

Regras de formulação de instruções que mudam o rumo do resultado
Estas são as alavancas que você controla no nível do prompt. Cada uma empurra a saída de forma confiável na direção previsível.
Use o imperativo, não a descrição
Escreva "remova a lixeira no canto inferior direito", não "há uma lixeira que não deveria estar ali". O modo imperativo corresponde diretamente à operação de edição. O modo descritivo soa como descrição de cena e convida à regeneração.
Nomeie o alvo, não a imagem inteira
"A placa acima da porta" é melhor que "o texto na imagem". Se sua imagem tem três placas, diga qual delas ("a placa de madeira pendurada acima do vão à esquerda"). Âncoras espaciais — esquerda, direita, topo, primeiro plano, atrás do sujeito — custam quase nada e eliminam a maior parte da ambiguidade.
Uma edição por instrução
Se você precisa de duas mudanças, só as encadeie com ponto e vírgula quando atuarem na mesma região: remove the chair; keep the floorboards and shadows beneath it. Edições não relacionadas devem ficar em chamadas separadas. Empilhar mudanças não relacionadas em um único prompt é a causa mais comum de danos colaterais.
Ordem: restrições antes do estilo
Coloque restrições de preservação e escopo antes de qualquer adjetivo opcional. Keep the background, wardrobe, and expression unchanged; restyle the lighting to soft window light funciona. Já Restyle to soft cinematic lighting, keep background unchanged deixa o tratamento cinematográfico vazar para o quadro inteiro. O modelo trata o que leu por último como sua estrutura de referência dominante, então termine com o que não pode se mover.
Declare o estado final, não os passos
"Deixe o céu nublado, coberto por uma camada uniforme de nuvens cinzentas" é um objetivo. "Dessature, adicione nuvens, reduza o contraste" é um fluxo de trabalho que o modelo não vai seguir literalmente e pode aplicar em excesso. Descreva o resultado que você quer ver.
Evite negações quando houver um alvo positivo
"Remova a marca d'água" é aceitável, pois a remoção é a própria operação. Mas "não deixe ficar embaçado" é mais fraco que "mantenha o sujeito nítido e em foco". Sempre que possível, formule a restrição como uma invariante positiva.
Seja breve
Receitas com mais de duas frases diluem a instrução. Se seu prompt precisa de um parágrafo inteiro, provavelmente você tem duas edições ou um alvo mal especificado.
Receitas prontas para colar para edições comuns
Cada receita abaixo pode ser colada diretamente. Substitua as partes entre colchetes pela sua situação específica. A justificativa explica por que a formulação foi construída assim — aprenda o padrão, não apenas o texto.
Substituição de objeto
replace the [object] at [spatial anchor] with [new object]; keep the surrounding [key surface, e.g. table/floor] and lighting unchanged
Justificativa: a âncora mais a cláusula de preservação tornam a composição verossímil. Nomear a superfície ao redor evita que o modelo re-renderize o contexto.
Remoção de objeto
remove the [object] at [spatial anchor]; reconstruct the background behind it to match the surrounding [surface] and fill the shadow naturally
Justificativa: a remoção exige especificar o que entra no lugar. Sem "reconstruct the background", você costuma obter uma mancha ou um remendo desalinhado.
Substituição de fundo
replace the background with [new setting]; keep the subject's silhouette, edge detail, and lighting direction identical
Justificativa: detalhes de borda e direção da luz são onde a substituição de fundo falha. Nomeá-los explicitamente é o que os preserva.
Edição de texto em placa
change the text on the [sign/label] to read "[new text]"; keep the font weight, perspective, and material of the sign unchanged
Justificativa: alvo curto e inequívoco, com travamento da perspectiva da fonte. Mantenha o novo texto curto — strings longas são exatamente onde os artefatos aparecem.
Mudança de cor e material
recolor the [object] to [color]; preserve the original texture, folds, and highlight placement
Justificativa: usar "recolor" em vez de "change the color to" deixa a instrução mais compacta, e a cláusula de textura evita preenchimento chapado.
Outpainting / extensão
extend the image to the [left/right/top] by roughly [fraction, e.g. one third]; continue the existing [surface, e.g. wall/ground] seamlessly and match the current lighting
Justificativa: nomear a superfície a continuar e a iluminação a igualar é exatamente o que separa uma extensão limpa de uma emenda visível.
Ajuste fino de pose ou expressão
adjust the subject's expression to a slight smile; keep head angle, hair, and the rest of the face unchanged
Justificativa: "o resto do rosto inalterado" é a barreira de proteção. Sem cercar os traços vizinhos, edições faciais derivam.
Reestilização com escopo limitado
apply a [style, e.g. watercolor] treatment to the foreground subject only; leave the background photographic and unchanged
Justificativa: prompts de reestilização são a maior fonte de aplicação excessiva. Limitar o escopo do estilo é obrigatório, não opcional.

Integrando as receitas ao seu código
Receitas são strings — trate-as como strings no seu código, com parâmetros e versões.
Parametrize, não concatene
Armazene as receitas com slots nomeados e preencha no momento da chamada:
RECIPES = {
"object_replace": "replace the {object} at {anchor} with {replacement}; "
"keep the surrounding {surface} and lighting unchanged",
"object_remove": "remove the {object} at {anchor}; reconstruct the background "
"behind it to match the surrounding {surface} and fill the shadow naturally",
}
def build(recipe_key, **slots):
return RECIPES[recipe_key].format(**slots)
Isso mantém a formulação estável em milhares de imagens. Se uma receita precisa de ajuste, você muda uma string em vez de centenas de pontos de chamada.
Mantenha a imagem de entrada fixa em cada comparação
Ao ajustar uma receita, reuse uma imagem de linha de base. Mudar o prompt e a imagem de entrada ao mesmo tempo torna impossível atribuir a diferença a um ou outro.
Valide os slots antes da chamada
Uma âncora vazia é pior que uma âncora errada — ela amplia o escopo da edição silenciosamente. Garanta que todo slot esteja preenchido e que slots de texto livre (como o novo texto de uma placa) sejam curtos.
Uma edição por requisição
Como as edições do Kontext Max são por chamada, modele seu pipeline como uma série de etapas de edição, cada uma com sua própria receita e parâmetros, em vez de um prompt gigante. Um pequeno executor de etapas que aplica receitas em sequência é muito mais fácil de depurar que uma única instrução monolítica.
Registre o prompt renderizado
Registre o prompt preenchido junto com a referência da saída e a versão da receita. Quando a qualidade da saída mudar, você precisa saber se a formulação mudou ou se o comportamento do modelo mudou.
O que fazer quando o resultado da edição sai errado
A maioria das falhas se encaixa em três categorias. Diagnostique o sintoma primeiro e aplique a correção correspondente.
Sintoma: o alvo não foi atingido
A edição acontece em outro lugar, ou não há mudança visível.
- Amplie e refine a âncora: "a placa acima da porta" → "a placa de madeira pendurada acima do vão à esquerda".
- Se o objeto for pequeno, diga isso: "o pequeno rótulo no canto inferior direito".
- Se o modelo alterou um objeto semelhante, acrescente um desambiguador: "a mais à esquerda entre as duas placas".
Sintoma: edição excessiva
Você pediu uma mudança e o modelo fez três.
- Adicione ou reforce a cláusula de preservação: nomeie exatamente os elementos que devem permanecer ("mantenha pose, vestuário e fundo inalterados").
- Mova a restrição para depois da instrução de mudança, ou repita-a no final — a posição importa.
- Separe prompts empilhados em chamadas separadas.
Sintoma: deriva
A ideia está certa, mas a imagem ao redor se deslocou — cores, iluminação ou detalhes mudaram.
- Converta exigências vagas de preservação em invariantes concretas: em vez de "mantenha igual", escreva "mantenha o balanço de branco original, a direção das sombras e a textura do tecido".
- Verifique se adjetivos de estilo estão vazando para fora; limite o escopo deles ("apenas o primeiro plano").
- Reduza a instrução à forma mínima e teste novamente na imagem de linha de base.
O ciclo
Execute a receita → classifique a falha como alvo não atingido, edição excessiva ou deriva → aplique a correção única correspondente → execute novamente na mesma entrada de linha de base. Mude apenas uma variável por iteração. Mudando duas ao mesmo tempo, você não saberá qual funcionou.
Mantenha um log de falhas curto: versão da receita, prompt preenchido, sintoma, correção, conclusão. Depois de alguns projetos, esse log valerá mais que qualquer prompt individual.

Construa sua própria biblioteca de receitas
Equipes que obtêm resultados consistentes com o Kontext Max não escrevem prompts avulsos melhores — elas mantêm um pequeno conjunto validado de prompts versionados.
Versione as receitas explicitamente
Dê a cada receita uma chave e uma versão (object_replace@v2). Quando você mudar a formulação, incremente a versão e mantenha a antiga disponível. Pequenas mudanças de formulação produzem saídas visivelmente diferentes, então uma biblioteca de prompts sem versionamento é uma fonte de regressões silenciosas.
Teste com uma suíte fixa
Mantenha um pequeno conjunto fixo de imagens de entrada e edições esperadas conhecidas — uma substituição, uma remoção, uma troca de fundo, uma edição de placa. Rode essa suíte a cada mudança de receita. Observe duas coisas: se o alvo foi editado e se a imagem ao redor permaneceu inalterada. Uma receita excelente na primeira e falha na segunda ainda não está pronta.
Compare receitas em vez de adivinhar
Quando duas formulações parecem razoáveis, execute as duas na mesma entrada de linha de base e mantenha a que respeita a cláusula de preservação. Comparar é barato; refazer um lote de imagens editadas, não.
Deixe a biblioteca crescer naturalmente
Comece com os oito padrões acima. Quando um colega resolver um novo caso de edição, adicione-o com uma nota explicando por que a formulação funciona. Com o tempo, a biblioteca se torna a documentação tribal de engenharia de prompts da sua equipe — e o material de introdução para qualquer pessoa nova na API.
Descontinue em vez de excluir
Sua janela de contexto de memória é curta. Uma receita que falha para um tipo de imagem pode ser perfeita para outro. Arquive receitas aposentadas e anote por que foram descontinuadas, para que a próxima pessoa não repita o erro.
Trate prompts como código: versione, teste, revise, reutilize. É essa disciplina que transforma o Flux-1 Kontext Max de demonstração em uma peça confiável do pipeline.
Artigos relacionados
Ver todos os artigos →-
Guia de uso
Guia de introdução ao seedream-5.0-pro/image-to-image: capacidades, preços e pontos de integração
Limites de capacidade, modelo de cobrança e práticas de integração de engenharia do modelo de edição de imagem da ByteDance
-
Guia de uso
Guia prático do seedream-5.0-pro text-to-image: limites de capacidade, integração via API e controle de custos
Perspectiva prática para desenvolvedores: dos pontos-chave dos parâmetros à estimativa de custo de US$ 0,05 por imagem
-
Guia de uso
Guia de introdução ao Hailuo 2.3 Fast image-to-video: limites de capacidade, preços e práticas de integração
Pontos-chave de seleção e integração do modelo image-to-video MiniMax para desenvolvedores