Receitas de prompts de geração de imagem por texto do Recraft v4.1 para desenvolvedores

Por que receitas de prompt são melhores que prompts avulsos

Toda equipe que chama uma API de geração de imagem por texto acaba esbarrando no mesmo muro: a imagem que ficou ótima tem seu prompt perdido no histórico do chat, num script descartável ou no aplicativo de notas de alguém. Quando o requisito do produto muda — "a mesma ilustração, mas com aparência fotográfica" ou "coloque um título na imagem" — ninguém sabe quais palavras fizeram efeito, então o prompt é reescrito do zero e a saída varia de forma imprevisível.

A receita de prompt resolve isso tratando o prompt como um pequeno documento parametrizado. Um esqueleto, alguns blocos substituíveis e uma lista curta de restrições. Mudar o estilo vira a edição de um único campo em vez de uma reescrita total, o que significa que você pode fazer diff dos prompts, revisá-los em pull requests e raciocinar sobre por que a saída mudou.

A receita também torna depuráveis as regressões de qualidade. Se a imagem de repente parece errada, você pode fazer uma busca binária: é o bloco de assunto, o de estilo, a instrução de layout ou a lista negativa? Com um prompt avulso, a resposta costuma ser "todos eles".

Este guia percorre um esqueleto concreto aplicável à geração de imagem por texto do Recraft v4.1 e traz as duas famílias de receitas prontas para copiar e colar mais usadas por desenvolvedores: ilustração e fotografia. A mesma estrutura se estende a controle de layout, texto na imagem e listas negativas.

O que uma receita contém de fato

Pense em cada receita como quatro partes:

• Esqueleto fixo — os blocos ordenados que todo prompt do seu repositório compartilha.
• Vocabulário de estilo substituível — as palavras que alternam a saída entre ilustração e fotografia.
• Cláusulas de restrição — instruções de layout, proporção, renderização de texto e exclusão.
• Rótulo de versão — o que permite rastrear um prompt em produção até a revisão exata que gerou aquele material.

Nada disso exige ferramentas especiais. Um arquivo JSON por receita, commitado no repositório junto ao código que chama a API, já basta.

O esqueleto do prompt: blocos que ficam e blocos que mudam

O esqueleto abaixo é deliberadamente entediante. Esse é justamente o ponto — as partes estáveis nunca deveriam precisar de edição, para que a atenção fique nas partes que mudam.

[SUBJECT]        o que está na imagem, descrito em linguagem simples
[STYLE]          vocabulário de meio e renderização
[COMPOSITION]    enquadramento, lente ou layout, proporção
[CONSTRAINTS]    renderização de texto, limites de paleta, regras proibidas

Quais blocos ficam e quais são substituídos

• SUBJECT — fica. Normalmente é o único bloco que a lógica do seu produto deveria parametrizar (um nome de produto, uma descrição de cena vinda da entrada do usuário).
• STYLE — substituído. A diferença entre ilustração e fotografia está quase toda aqui.
• COMPOSITION — substituído em boa parte, mas a forma das instruções se mantém (primeiro enquadramento, depois proporção).
• CONSTRAINTS — parcialmente compartilhado. A lista negativa e a regra "sem texto a menos que especificado" costumam ser globais; as instruções de renderização de texto dependem da requisição.

O modelo mínimo como dados

{
  "recipe_id": "product-hero",
  "version": "3",
  "subject": "a ceramic coffee mug on a plain surface",
  "style": "{{style_block}}",
  "composition": "centered, generous negative space above the subject, square aspect",
  "constraints": ["no text in image", "no watermark"],
  "negatives": "{{negative_list_v2}}"
}

O placeholder {{style_block}} é a costura. O restante ou é compartilhado entre receitas, ou fornecido por quem chama. Quando você adicionar uma terceira família de estilo mais adiante — digamos, 3D isométrico — basta adicionar um bloco de estilo, não um novo arquivo de prompt.

Um lembrete prático: mantenha a ordem dos blocos consistente em todas as receitas. Não há garantia de que o modelo seja sensível à ordem de forma documentada, mas sua equipe é. Uma ordem consistente torna os prompts comparáveis e faz a revisão lado a lado valer a pena.

Receita de ilustração: estilos flat, vetorial e editorial

A receita de ilustração é o ponto de partida da maioria das equipes, porque ilustração tolera bem a simplificação — o que a torna uma boa escolha para testar o esqueleto sem brigar com o fotorrealismo.

Ilustração flat

[SUBJECT] a developer workspace with a laptop, notebook and coffee mug
[STYLE] flat vector illustration, solid fills, no gradients, bold simple shapes, limited four-color palette, clean geometric forms
[COMPOSITION] centered composition, even margins, square aspect
[CONSTRAINTS] no text in image, no shadows, no textures

As palavras que produzem esse visual: flat, preenchimentos sólidos, sem gradientes, formas arrojadas e simples. Cada palavra trabalha. Remova "sem gradientes" e você costuma ver sombras suaves se infiltrarem.

Ícone em estilo vetorial

[SUBJECT] a single shield icon with a checkmark
[STYLE] minimal vector icon, uniform stroke weight, rounded line caps, two-tone, high contrast on plain background
[COMPOSITION] centered, icon fills most of the frame, square aspect
[CONSTRAINTS] no text, no background scenery, no gradients

Prompts de ícone se beneficiam de qualificadores explícitos — único, espessura de traço uniforme — porque sem eles você costuma obter uma pequena cena em vez de um símbolo gráfico.

Ilustração editorial

[SUBJECT] a person reviewing charts on a large screen
[STYLE] editorial illustration, muted palette, subtle grain, hand-drawn line quality, slightly abstracted human figures, magazine feature style
[COMPOSITION] subject offset to the right, breathing room on the left, landscape aspect
[CONSTRAINTS] no text in image, no photorealism, no logos

O estilo editorial fica no meio-termo: mais textura e personalidade que o vetor flat, mas ainda claramente não fotográfico. Combinar paleta suave com granulação sutil é o que impede que ele deslize para qualquer um dos extremos.

Dica de ajuste: mude um adjetivo de estilo por vez. Trocar "paleta suave" por "paleta vibrante" é um experimento real; trocar cinco palavras de uma vez não é.

Receita de fotografia: realismo, estúdio e enquadramento lifestyle

A receita de fotografia usa o mesmo esqueleto, apenas com vocabulário diferente. Note que o bloco de assunto quase não muda — esse é o retorno da modelagem.

Foto de produto limpa de estúdio

[SUBJECT] a ceramic coffee mug on a plain surface
[STYLE] professional studio product photography, soft diffused key light, gentle falloff, neutral background, sharp focus, realistic material detail
[COMPOSITION] centered, slight three-quarter angle, generous negative space above, square aspect
[CONSTRAINTS] no text in image, no props, no harsh reflections

O vocabulário fotográfico se agrupa em torno de luz (difusão suave, queda de luz), óptica (foco nítido, profundidade de campo) e realismo de material (detalhe realista do material). O vocabulário de ilustração se agrupa em torno de forma e preenchimento. Esse contraste é toda a diferença entre as duas famílias de receitas.

Lifestyle ambiental

[SUBJECT] a person working at a wooden desk near a window
[STYLE] candid lifestyle photography, natural window light, shallow depth of field, warm neutral tones, realistic skin and fabric texture
[COMPOSITION] over-the-shoulder framing, subject left of center, landscape aspect
[CONSTRAINTS] no text in image, no visible brand marks, no exaggerated saturation

Espontâneo e luz natural de janela afastam a saída do polimento de estúdio. Se o resultado parecer posado demais, muitas vezes é tanto um problema de composição quanto de estilo — acrescentar "enquadramento sobre o ombro" ajuda mais do que empilhar mais adjetivos.

Converter uma receita de ilustração em fotografia

Dada uma receita de ilustração que funciona, a conversão é mecânica:

1. Substitua o bloco [STYLE] inteiro pelo vocabulário fotográfico.
2. Ajuste [COMPOSITION] só quando o enquadramento diferir (ângulo importa mais em fotografia).
3. Mantenha [SUBJECT] idêntico byte a byte.
4. Preserve as negativas globais; remova as específicas de ilustração que não se aplicam mais, como "sem gradientes".

Se o resultado fotográfico inventar ou descartar elementos do assunto, provavelmente o bloco de assunto está mal descrito — corrija ali, não acrescentando palavras de estilo compensatórias.

Controlar layout e renderização de texto

Layout e texto são as duas coisas que os desenvolvedores mais esperam que o modelo deduza sozinho, e exatamente as duas coisas que mais valem a pena explicitar. Trate-as como blocos de prompt separados do estilo.

Linguagem de posição que realmente restringe

Vago: "uma imagem de banner para uma landing page."

Explícito:

[COMPOSITION] landscape 16:9 frame; subject occupies the right two-thirds;
left third is empty open space suitable for a headline; horizon line at
lower third; nothing enters the left third

Três hábitos deixam as instruções de posição mais firmes:

• Nomeie o quadro primeiro, depois descreva o posicionamento ("quadro horizontal 16:9").
• Declare explicitamente a área reservada e afirme que nada entra nela. Espaço vazio não é o estado padrão.
• Ancore nas linhas dos terços, em vez de usar termos não mensuráveis como "um pouco fora do centro".

Renderização de texto

Quando você quiser texto na imagem, isole-o num bloco e cite a string exata:

[TEXT] render exactly the words "Ship faster" in a bold sans-serif,
placed in the reserved left third, vertically centered, single line,
high contrast against a plain background. No other text anywhere.

Pontos que reduzem iterações:

• Cite a string literal — nunca a reformule dentro do prompt.
• Diga "exatamente" e "nenhum outro texto" — caso contrário, palavras sobrantes aparecem nos cantos ou nos objetos.
• Especifique o número de linhas ("linha única"), senão a quebra de linha vira adivinhação.
• Especifique um fundo de contraste ("sobre fundo liso"), para o texto ter no que se apoiar.
• Mantenha o texto totalmente separado do bloco [STYLE]; misturar torna os dois mais difíceis de ajustar.

Se uma requisição exigir tipografia precisa de vários elementos, trate a geração de texto como ponto de partida e planeje uma camada de texto real na etapa seguinte. O controle de texto no nível do prompt serve para títulos curtos e rótulos, não para corpos de texto densos.

Listas negativas: o que excluir e como versionar

A lista negativa é seu mecanismo de controle de qualidade mais barato. Em vez de descrever o que você quer, você aponta os modos de falha que se recusa a aceitar.

Categorias que vale a pena excluir

Organize as negativas por categoria, para poder expandi-las sem criar contradições:

• Artefatos de texto — palavras estranhas, glifos corrompidos, marca d'água, assinatura.
• Artefatos de composição — assunto cortado, membros truncados, elementos duplicados, bordas poluídas.
• Artefatos de renderização — desfoque, banding, saturação excessiva, aspecto HDR agressivo, pele com aparência plástica.
• Higiene de conteúdo — logotipos de marca, marcas registradas reconhecíveis, retratos de pessoas reais.
• Deriva de estilo — fotorrealismo aparecendo numa receita de ilustração, aspecto de ilustração numa receita de fotografia.

A última categoria é a que as equipes mais esquecem. Se sua receita de ilustração vive derivando para o realismo, uma negativa explícita costuma ser mais confiável do que empilhar adjetivos de estilo.

Manter curto e sem contradições

Listas negativas longas demais saem pela culatra. Se uma negativa conflita com uma instrução positiva, o resultado fica instável e você não consegue dizer qual cláusula prevaleceu. Duas regras:

1. Nunca negue algo que você pediu. Se o bloco de composição pede sombras para dar profundidade, não liste "sem sombras" globalmente ao mesmo tempo.
2. Específico vence genérico. "Sem marca d'água" é acionável; "nada ruim" é ruído.

Versionar as listas negativas junto com os prompts

As negativas mudam o comportamento de toda receita que as referencia, então precisam da mesma rastreabilidade dos prompts:

{
  "negative_list_id": "global-v2",
  "entries": ["watermark", "signature", "stray text", "cropped subject", "duplicated elements", "oversaturated colors"]
}

Referencie a lista por ID em cada receita e incremente o ID ao editá-la. Quando a qualidade da saída se desloca após o deploy, "a lista negativa mudou?" vira uma linha de verificação no diff, em vez de uma investigação.

Comparar saídas reais antes de publicar

Antes de você olhar saídas reais, uma receita é só uma hipótese. O fluxo de comparação abaixo é deliberadamente leve — deve levar alguns minutos, não uma sprint.

O fluxo

1. Congele tudo menos uma variável. Mesmo bloco de assunto, mesma composição, mesmas negativas e, se a API expuser uma seed, a mesma seed. Mude apenas o bloco de estilo.
2. Gere uma pequena matriz. Duas ou três variantes de estilo combinadas com dois ou três assuntos representativos costuma bastar para expor uma receita ruim.
3. Revise lado a lado, não em sequência. A revisão sequencial induz viés de recência — a última imagem parece a melhor só porque é a mais fresca.
4. Avalie contra o requisito, não contra o gosto. Escreva para que o material serve (banner hero, conjunto de ícones, cabeçalho editorial) e verifique as propriedades concretas que importam: o espaço reservado está realmente vazio, há texto estranho, há deriva de estilo.
5. Promova com intenção. Só a revisão de receita que passou na revisão entra no código de produção, com seu rótulo de versão.

O que observar

• Consistência entre assuntos. Um bloco de estilo que funciona num assunto e desmorona em outro ainda não está pronto.
• Aderência às restrições. O terço esquerdo reservado permaneceu vazio? A string exata citada aparece só uma vez?
• Concentração de falhas. Se o mesmo artefato aparece em várias variantes, ele deve entrar na lista negativa, não virar ajuste fino de estilo.

Guardar tudo no repositório

Mantenha o JSON da receita, as versões da lista negativa e os registros de revisão juntos. Quando alguém perguntar, seis meses depois, por que a imagem hero é assim, a resposta será um commit, não uma lembrança.

Assim que uma receita passa por esse ciclo, alternar um dado assunto entre ilustração e fotografia vira a edição de um único campo — exatamente a propriedade de manutenção que o esqueleto foi desenhado para oferecer. Rode essas receitas na geração de imagem por texto do Recraft v4.1 por meio de uma API unificada e versione cada revisão de prompt junto com o código que a chama.