Receitas de prompts do imagen4-fast: prompts prontos para copiar e colar por desenvolvedores

Por que receitas de prompts superam prompts avulsos

A maioria dos problemas de geração de imagem não é culpa do modelo, mas do prompt — e é difícil de corrigir, porque o prompt costuma existir apenas no histórico de conversa de alguém ou num documento desatualizado. Um prompt avulso que produziu um ótimo resultado na terça-feira não se reproduz na sexta, porque você não consegue dizer exatamente o que havia nele.

Uma receita de prompt resolve isso do mesmo jeito que funções resolvem a lógica copiada e colada. Ela tem estrutura fixa, slots nomeados e identificadores estáveis, para que você possa referenciá-la depois. Quando a saída muda, você tem algo para comparar.

Os ganhos práticos aparecem rápido:

• Consistência entre chamadas. A mesma receita com as mesmas entradas produz composições e estilos comparáveis; isso é essencial quando uma página precisa renderizar doze imagens de card numa grade.
• Iteração barata. Você altera um slot por vez em vez de reescrever prosa solta, perdendo o que já funcionava.
• Rastreabilidade. Receitas têm versão. Quando o time de marca pergunta por que as miniaturas parecem mais chapadas que no mês passado, você consegue fazer uma busca binária.
• Revisabilidade. Receitas podem ser revisadas em pull requests como qualquer outro recurso, e quem revisa não precisa ganhar a vida escrevendo prompts.

O restante deste artigo é um manual. Cada receita segue o mesmo esqueleto, então você pode ler uma, adaptá-la e colocá-la no seu código sem refatorar. Trate o modelo como um componente e a receita como a interface que você constrói sobre ele.

Uma ideia para guardar: uma receita não é um encantamento mágico. É um contrato entre o slot da UI a jusante e a chamada de geração. O slot da UI decide a moldura; a receita decide o que preenche-la.

O esqueleto base do prompt

Toda receita deste manual é construída sobre o mesmo esqueleto de quatro partes. Copie este trecho e preencha os slots:

[subject] — [composition] — [style] — [constraints]

A ideia central é só isso. Abaixo, uma versão preenchida, pronta para colar e usar:

A lone ceramic coffee cup on a pale oak desk, three-quarter view, shallow depth of field,
soft morning light from the left, minimal editorial product photography, muted warm palette,
no text, no logos, no hands, centered subject with breathing room on all sides

O papel de cada slot

Subject (Sujeito) é a única coisa sobre a qual a imagem trata. Nomeie de forma específica: "caneca de cerâmica", não "clima de café". Se o sujeito tem ação ou estado, coloque aqui também: "um desenvolvedor no meio de digitar num teclado diante de uma mesa mal iluminada". Resista à tentação de adicionar um segundo sujeito; essa é a causa mais comum de resultados confusos.

Composition (Composição) controla a moldura. Ângulo de visão (três quartos, vista de cima, nível dos olhos), posição do sujeito (centralizado, terço esquerdo), recorte (quadro cheio, recorte apertado) e profundidade de campo ficam aqui. É neste slot que você codifica a intenção de proporção em texto, mesmo que a proporção real seja um parâmetro separado.

Style (Estilo) é um pequeno vocabulário visual: meio (fotografia, vetor plano, aquarela), iluminação (luz suave da manhã, luz dura de contorno), paleta (tons quentes suaves, monocromático de alto contraste) e textura (fosco, brilhante, granulado). Mantenha em uma a três frases curtas. Blocos de estilo mais longos costumam brigar entre si.

Constraints (Restrições) é o espaço negativo. O que não pode aparecer: texto, logotipos, marcas d'água, membros extras, fundo desordenado, sombras duras. Restrições são um seguro barato e a primeira coisa a expandir quando a receita dá problema.

Duas variantes que vale ter sempre à mão

Foto de objeto minimalista:

[object] on a seamless [color] backdrop, centered, straight-on view, soft even studio light,
clean commercial product photography, no shadows on background, no text, no props

Foto de cena editorial:

[scene subject] in [environment], wide establishing view, natural light, subtle film grain,
documentary photography, muted palette, no text, no logos, no visible brand marks

Ambas são deliberadamente curtas. Se o seu prompt é uma pilha de adjetivos, provavelmente você deixou o slot de composição perdido em algum lugar ali dentro.

Escolha a proporção antes de escrever o prompt

Escreva o prompt depois de saber a forma do buraco que vai preencher. A proporção é uma decisão de produto, não de prompt; escolhê-la tarde demais força você a reescrever a frase de composição que já estava ajustada.

Um mapeamento simples que cobre a maioria das interfaces:

• Banners de destaque e cabeçalhos de página — quadro largo. Termos de composição: "wide establishing view", "horizon placed in the lower third", "negative space on the left for headline overlay".
• Cards e blocos de grade — quadrado ou quase quadrado. Termos de composição: "centered subject", "even margins", "no important detail near the edges".
• Avatares e miniaturas de perfil — quadrado, recorte apertado, sujeito único. Termos de composição: "head and shoulders", "centered face", "plain background".
• Miniaturas e linhas de lista — recorte largo ou quadrado pequeno, o sujeito precisa continuar reconhecível ao ser reduzido. Termos de composição: "single dominant subject", "high contrast against background", "no fine detail".
• Conteúdo editorial ou ilustração de texto longo — quadro vertical. Termos de composição: "vertical composition", "subject occupies the upper two thirds", "foreground anchor at the bottom".

Por que o texto precisa combinar com a moldura

Uma frase de composição escrita para um banner largo ("negative space on the left") perde o sentido quando cortada em quadrado; e um recorte vertical apertado descrito em texto será espremido se você pedir um quadro largo. O prompt e a proporção devem estar de acordo, porque você está descrevendo o mesmo retângulo duas vezes — uma em linguagem, outra em parâmetros.

Fluxo de trabalho prático

1. Olhe o slot real da UI, anote sua proporção e como ele é cortado em telas pequenas.
2. Escolha a proporção suportada mais próxima, em vez de pedir ao modelo para falsificá-la com margens.
3. Escreva o slot de composição em torno dessa moldura, incluindo onde o espaço negativo deve ficar.
4. Depois de gerar, verifique o pior caso de corte (mobile, grade reduzida), não o caso ideal.

Se uma receita precisa atender dois slots muito diferentes, faça duas receitas. Duplicar uma receita vale mais do que escrever uma frase de composição que funciona mais ou menos em todo lugar.

Blocos de pistas de estilo intercambiáveis por interface

O slot de estilo é a parte que você deve esperar mudar com mais frequência, então torne-o modular. Escreva as pistas de estilo como um bloco autocontido, acoplado ao esqueleto base, e mantenha um bloco por interface ou tom de marca.

Seguro para marca / neutro

minimal editorial photography, soft diffused light, muted neutral palette,
clean background, product-focused, no text, no logos

Para páginas de marketing, onde a imagem não pode competir com o texto nem sugerir uma promessa de marca.

Fotográfico / documental

natural light, documentary photography, shallow depth of field, subtle grain,
unposed subject, realistic color, no heavy filters

Para ilustrações editoriais e interfaces narrativas, onde o realismo funciona melhor que o polimento.

Ilustração plana

flat vector illustration, limited two-color palette, bold simple shapes,
no gradients, generous whitespace, geometric composition, no text

Para onboarding, estados vazios e documentação, onde a imagem precisa combinar com o design system.

Foto de produto de estúdio

seamless studio backdrop, soft even key light, crisp shadows, high detail on the subject,
commercial catalog photography, no props, no text

Para catálogos de produtos e grades de comparação, onde a consistência entre várias imagens importa mais do que qualquer imagem isolada.

Como trocar sem degradar

• Trate o bloco de estilo como uma variável, nunca o intercale com o sujeito ou a frase de composição. Se as palavras de estilo estiverem espalhadas pelo prompt, você não consegue substituí-las de forma limpa.
• Mude um bloco por vez e regenere com o mesmo sujeito e a mesma composição. Se duas variáveis mudarem ao mesmo tempo, você não consegue saber qual causou a diferença.
• Cuidado com blocos de estilo que contrabandeiam composição. "Centered" e "close-up" pertencem à composição, não ao estilo; se morarem no bloco de estilo, seu esforço com proporção será silenciosamente anulado.
• Pode blocos que crescem demais. Três frases de estilo normalmente bastam; cinco começam a competir entre si.

Um teste útil: troque o bloco de estilo numa receita que fora isso está idêntica e veja se a saída ainda se encaixa no mesmo slot da UI. Se encaixa, o bloco está bem isolado.

Parametrize prompts no código

Receitas devem existir como templates, não como literais de string espalhados pelos handlers. Um template com variáveis nomeadas te dá de graça testes A/B, rollback e sobrescritas por interface.

Forma do template

RECIPE = {
    "id": "product-hero-v3",
    "template": (
        "{subject} — {composition} — {style} — {constraints}"
    ),
    "defaults": {
        "composition": "centered subject, generous margins, eye-level view",
        "style": "minimal editorial photography, soft diffused light, muted neutral palette",
        "constraints": "no text, no logos, no watermark, clean background",
    },
    "aspect_ratio": "1:1",
}


def render(recipe, **overrides):
    slots = {**recipe["defaults"], **overrides}
    return recipe["template"].format(**slots)

O objeto de receita carrega seu identificador (id), a moldura (aspect_ratio) e os valores padrão. O chamador fornece apenas o que difere. Isso mantém o ponto de chamada curto e deixa a diferença entre duas interfaces óbvia.

Variantes para testes A/B

Modele variantes como sobrescritas sobre a receita base, não como strings bifurcadas:

variants = {
    "control": {},
    "warm": {"style": "minimal editorial photography, warm afternoon light, muted warm palette"},
    "tight": {"composition": "tight crop, subject fills the frame, eye-level view"},
}

Como toda variante compartilha sujeito e restrições, a diferença no resultado pode ser atribuída ao slot que você mudou. Esse é todo o valor do exercício.

Rollback e fixação

• Dê a cada receita uma versão no id e registre-a em cada requisição de geração. Quando a saída mudar, o log dirá qual versão da receita produziu o quê.
• Mantenha versões antigas endereçáveis por um período. Rollback deve ser uma mudança de configuração, não um revert de código sob pressão.
• Ao enviar para seu sistema de análise, use o id da receita, não a string renderizada, para poder agrupar resultados por receita e não pelo texto exato do prompt.
• Valide os slots antes de chamar a API — um subject vazio deve falhar rápido na sua aplicação, não gerar uma imagem vaga.

Trate a proporção como um parâmetro de primeira classe ao lado do template, porque ela é decidida pelo slot da UI, não pelo texto do prompt. Tudo o que a API precisa deve derivar de um objeto de receita, para que cada interface tenha uma única fonte de verdade.

Modos de falha comuns e como depurar

A maioria das saídas ruins pode ser rastreada até um slot. Use esta lista para decidir qual parte do esqueleto ajustar antes de reescrever o prompt inteiro.

Sujeito cortado ou fora do quadro

Sintoma: cabeça cortada, objeto transbordando as bordas, detalhe importante fora da área segura.

Corrija o slot de composição, não o de estilo. Adicione linguagem explícita de enquadramento ("full subject in frame", "generous margins on all sides") e confirme que a proporção corresponde à moldura pretendida. Se o sujeito é alto e o slot é largo, a moldura está errada, não o prompt.

Resultado confuso

Sintoma: múltiplos focos competindo, fundo movimentado, adereços que você não pediu.

Corrija o slot de sujeito. Reduza a um sujeito, um estado. Mova qualquer coisa que possa ser lida como adereço para as restrições como exclusão. Confusão costuma ser sujeito vago, não entusiasmo excessivo do modelo.

Estilo inconsistente num lote

Sintoma: algumas imagens da grade parecem fotografia, outras ilustração; a paleta varia.

Corrija o bloco de estilo. Encurte-o para um meio, uma frase de iluminação, uma frase de paleta. Remova palavras de estilo que vazaram para outros slots e divida receitas que servem duas interfaces diferentes ao mesmo tempo. Inconsistência num lote costuma ser sintoma de um bloco de estilo diferente a cada chamada.

Aparecimento de texto ou logotipos

Sintoma: letras embaralhadas, marcas d'água falsas, marcas parecidas com logos.

Expanda as restrições: "no text, no lettering, no logos, no watermarks, no signage". Se a composição sugere um suporte que normalmente tem texto (tela, embalagem, pôster), ou declare isso explicitamente, ou mude a composição.

A saída ignora o clima pedido

Sintoma: a imagem está correta, mas parece chapada, dura ou genérica.

Corrija o bloco de estilo, uma frase por vez. Iluminação costuma ser a mudança de maior alavancagem; paleta vem em segundo. Regenere com o mesmo sujeito e composição para que a comparação seja honesta.

Todos os outros casos

Se dois slots parecem suspeitos, mude um e regenere. Se o resultado ainda estiver errado, dê um passo atrás e verifique se a receita está sendo forçada a servir um slot da UI para o qual nunca foi escrita — isso é descompasso de produto, não defeito de prompt.

Publique a biblioteca de receitas

Assim que as receitas viram templates versionados, elas se tornam ativos que o time mantém junto com o código. O objetivo é que qualquer pessoa consiga encontrar a receita por trás de uma interface, entender por que ela tem essa forma e alterá-la com segurança.

Organize por interface, não por texto de prompt

Agrupe receitas pelo lugar onde renderizam: hero, card, avatar, thumbnail, editorial-figure. Um desenvolvedor olhando a página de preços deve chegar à receita usada por aquela página, não a uma lista alfabética de adjetivos. Dê a cada receita um id estável e um sufixo de versão, e mantenha os padrões dentro do objeto de receita.

Revise receitas em pull requests

Trate mudanças de receita como mudanças de componente. O diff deve mostrar qual slot mudou e por quê. Quem revisa pode fazer perguntas úteis: a composição ainda combina com a moldura, palavras de estilo vazaram para a composição, as restrições encolheram? Diffs pequenos, de um único slot, são fáceis de revisar; reescritas inteiras não são.

Versione, registre e limpe

• Registre o id e a versão da receita em cada requisição de geração, para que mudanças na saída sejam rastreáveis até uma alteração.
• Mantenha versões descontinuadas endereçáveis até que nenhuma interface as referencie, e então remova-as numa rodada de limpeza, em vez de deixar receitas mortas para sempre.
• Quando adicionar variantes, promova a vencedora a uma nova versão em vez de manter o ramo A/B como caminho permanente.

Documente o contrato

Para cada receita, registre o slot da UI pretendido, a proporção e as restrições que não podem ser descartadas. Duas frases bastam. A próxima pessoa a mexer nessa receita precisa saber o que ela não pode quebrar.

Mantenha o ciclo curto

Receitas apodrecem quando ninguém as regenera depois de uma mudança de design. Encaixe um passo leve de revisão em qualquer trabalho de UI que altere um slot de imagem, e rode de novo as receitas afetadas como parte dessa mudança. Só com o ciclo de feedback curto o sistema inteiro continua barato.

Comece pelo esqueleto base, adicione um bloco de estilo por interface e deixe a biblioteca de receitas crescer a partir de slots reais, não de slots hipotéticos. Se você está conectando a geração ao seu aplicativo, mantenha o ponto de chamada enxuto e deixe o objeto de receita carregar as decisões.