Guia de uso
Receitas de prompts de geração de imagem por texto do Recraft v4 Styles: prompts prontos para copiar e resultados reais
Guia de referência de estilo voltado a desenvolvedores, cobrindo ilustração e tonalidades fotográficas
Anatomia de um prompt recraft-v4-styles
Toda equipe que entrega imagens geradas acaba esbarrando no mesmo obstáculo: alguém lapida um prompt, o resultado fica impressionante uma vez, a pessoa cola num bloco de notas e, seis semanas depois, ninguém consegue reproduzir aquele resultado. Aquele prompt foi ajustado para uma única execução, sem nenhum registro de quais palavras realmente fizeram efeito. Assim que o modelo, os parâmetros ou os membros da equipe mudam, o resultado deriva, e não há uma linha de base à qual voltar.
Receitas de prompt resolvem isso: tratam o prompt como um artefato estruturado e versionado, e não como uma string misteriosa. Uma receita separa as partes do prompt que têm responsabilidades diferentes — sujeito, referência de estilo, tonalidade e restrições — de modo que cada parte possa ser modificada de forma consciente e isolada. Essa estrutura entrega três coisas que os desenvolvedores realmente valorizam:
- Reprodutibilidade. Com uma receita fixa, parâmetros fixos e uma seed fixa, a equipe consegue regerar uma imagem comparável meses depois.
- Testabilidade. Você pode comparar em A/B duas receitas que diferem apenas num único slot e atribuir a diferença a esse slot.
- Custo de onboarding. Membros novos leem a biblioteca de receitas, em vez de tentar decifrar por engenharia reversa a intuição de alguém.
Este guia está organizado como um livro de receitas, voltado para recraft-v4-styles/text-to-image. Cada seção de receita apresenta um padrão de prompt pronto para copiar, específico para uma tarefa: orientação por referência de estilo, progressão de tonalidade de ilustração e progressão de tonalidade fotográfica. As últimas seções tratam de como ler os resultados reais, iterar uma variável por vez e como chamar as receitas no código da aplicação por meio de uma interface unificada de modelos.
Os prompts aqui são pontos de partida, não garantias. Modelos de imagem são sensíveis à escolha de palavras, e pequenas mudanças podem deslocar visivelmente a saída. Trate cada receita como uma linha de base que você precisa ajustar e medir novamente.
Uma observação sobre a estrutura do prompt: separe cada slot com delimitadores claros (pontos finais, quebras de linha ou trechos rotulados), para que você e sua equipe possam ler o prompt como uma especificação, e não como um texto corrido.
Como usar este livro de receitas
- Escolha a receita que corresponde ao tipo de saída desejado (orientação de estilo, ilustração ou fotografia).
- Copie-a, substitua o sujeito no slot de sujeito e faça uma execução única como linha de base.
- Compare com a sua intenção (veja "Ler os resultados reais e iterar").
- Ajuste um slot por vez e registre essa mudança ao lado da saída.
Esse ciclo — receita, execução, comparação, mudança única — é a disciplina central sobre a qual todo o restante deste artigo se apoia.

Receita de orientação por referência de estilo

Receita de tonalidade de ilustração
A orientação por referência de estilo é a parte de recraft-v4-styles que mais exige rigor no prompt. O objetivo é fazer o resultado herdar a aparência da referência — sua paleta, textura de traço, tratamento de renderização — sem copiar seu conteúdo literal. A abordagem confiável é descrever em texto as propriedades visuais da referência e colocá-las num slot separado, mantendo o slot de sujeito isolado.
Receita S1 — Orientação por referência baseada em atributos
sujeito: uma raposa sentada em capim alto, vista em três quartos
referência de estilo: paleta de tons terrosos suaves, aguadas delicadas de aquarela, grão de papel visível, contorno fino e irregular, sombras de baixo contraste, sem preto puro
tonalidade: ilustração calma e naturalista
composição: sujeito centralizado, amplo espaço negativo acima
restrições: sem texto, sem assinatura, sem moldura
Esta é a receita mais portável: você não está colando uma imagem de referência, está descrevendo o que torna a referência reconhecível. Ela resiste melhor a atualizações do modelo do que copiar nomes de estilo.
Receita S2 — Intensidade de referência, toque leve
sujeito: um bule de cerâmica sobre uma prateleira de madeira
referência de estilo: uma homenagem sutil à arte de cartaz de meados do século — formas simplificadas, paleta de duas cores, leve textura de impressão
tonalidade: contida, plana
restrições: fundo de cor sólida, sem gradientes, sem texto
Observe a expressão "homenagem sutil". A intensidade da orientação é, em grande parte, uma questão de formulação: linguagem vaga ("homenagem sutil", "livremente inspirado em", "ecoando levemente") permite que o sujeito domine, enquanto linguagem forte ("adotando fortemente o estilo de...", "dominado por...") faz a referência assumir o controle.
Receita S3 — Referência dominante, sujeito secundário
referência de estilo: arte vetorial plana e ousada, formas geométricas pesadas, paleta complementar de alta saturação, bordas nítidas, sem textura
sujeito: uma cadeia de montanhas, simplificada em triângulos empilhados
tonalidade: com cara de cartaz, confiante
restrições: sem texto, sem gradientes, sem detalhes fotográficos
Quando a referência deve dominar, coloque-a em primeiro lugar e descreva o sujeito já traduzido para a linguagem visual da referência ("simplificada em triângulos empilhados"). Isso evita uma falha comum: o sujeito mantém detalhes fotográficos enquanto o fundo se torna plano.
Mudar a intensidade sem reescrever o todo
Mantenha os slots de sujeito, tonalidade, restrições e composição idênticos byte a byte, e altere apenas a frase de orientação dentro do slot de referência de estilo:
ecoando levemente→homenagem sutil→capturando o espírito de→adotando fortemente o estilo de
Registre cada variante junto com a sua saída. Depois de três ou quatro execuções, você saberá qual frase mais se aproxima da intenção sob aquela referência, e então poderá congelá-la na receita.
Armadilhas comuns
- Nomear marcas ou artistas vivos como referência de estilo costuma gerar resultados inconsistentes e, às vezes, evasivos. Descreva atributos em vez disso.
- Misturar duas referências no mesmo slot leva à média. Se precisar de uma mistura, escreva dois trechos de referência claramente rotulados e indique qual domina.
- Omitir restrições atrai artefatos de texto, assinaturas e molduras.
Receita de tonalidade fotográfica
Saídas de ilustração e saídas fotográficas respondem a vocabulários diferentes. Pense em termos de linha, forma, textura e modelagem de claro-escuro, e não de lente e luz. As receitas abaixo pressupõem que você já preencheu o slot de sujeito com o seu próprio conteúdo.
Receita I1 — Vetor plano, paleta minimalista
sujeito: um entregador de bicicleta
-tonalidade: ilustração vetorial plana
referência de estilo: preenchimentos de cor sólida, paleta de duas cores mais uma cor de destaque, espessura de traço uniforme, formas geométricas arredondadas, sem gradientes, sem textura
composição: vista lateral, linha do horizonte simples, fundo de cor sólida
restrições: sem texto, sem sombras, sem contorno duplo
Receitas de estilo plano são as mais fáceis de manter consistentes num conjunto de assets, porque seu vocabulário é binário: sem gradientes, sem textura, espessura de traço uniforme. Use a mesma formulação para cada peça de um conjunto.
Receita I2 — Traço desenhado à mão
sujeito: uma planta de interior num vaso de terracota
tonalidade: ilustração a tinta desenhada à mão
referência de estilo: traço fino de espessura variável, leve tremido, hachuras cruzadas esparsas para as sombras, fundo branco-sujo, uma única cor de destaque em aguada
composição: centralizado, sujeito inteiramente enquadrado, margem pequena
restrições: sem texto, sem preenchimento colorido além da aguada de destaque
As palavras que realmente importam são espessura variável, tremido e hachuras cruzadas esparsas. Remova-as e você obtém um traço genérico; mantenha-as e a saída parece desenhada, não traçada.
Receita I3 — Ilustração com textura e claro-escuro
sujeito: um farol numa costa rochosa ao entardecer
tonalidade: ilustração pictórica com textura de pincelada visível
referência de estilo: pinceladas grossas e opacas, formas de sombra em camadas, transição de paleta do quente para o frio, grão de tela, bordas seletivamente suavizadas
composição: horizonte baixo, farol à direita do centro
restrições: sem texto, sem fotorrealismo, sem flares de lente
Para ilustrações com claro-escuro, diga como o claro-escuro é construído — formas em camadas, hachuras cruzadas ou aguadas suaves — em vez de apenas dizer "com sombras". Palavras vagas de claro-escuro produzem meios-tons lamacentos.
Receita I4 — Ilustração técnica isométrica
sujeito: o layout interno de um pequeno café
tonalidade: ilustração técnica isométrica
referência de estilo: projeção isométrica de 30 graus, cores sólidas, contorno fino e uniforme, formas de mobiliário simples e repetidas, sem distorção de perspectiva
composição: cena completa, fundo neutro, iluminação uniforme
restrições: sem rótulos de texto, sem pessoas, sem sombras além de sombras simples de contato
Receitas isométricas costumam falhar porque misturam linguagem de perspectiva. Declare explicitamente o modo de projeção e proíba termos fotográficos.
Tabela de consulta rápida de vocabulário
- Linha: espessura de traço uniforme, variável, afinando, tremido desenhado à mão, bordas nítidas.
- Forma: geométrica, arredondada, simplificada, triângulos empilhados, silhueta em primeiro lugar.
- Textura: grão de papel, grão de tela, textura de impressão, nenhuma.
- Claro-escuro: preenchimentos chapados, duas cores, hachuras cruzadas, formas de sombra em camadas, aguadas suaves.
Ler os resultados reais e iterar
Receitas fotográficas dependem de luz, sensação de lente, material e enquadramento. As mesmas palavras de sujeito que produzem ilustrações limpas produzem "fotos" planas se os slots fotográficos não forem adicionados. Mantenha o slot de tonalidade curto e coloque as características técnicas no slot de referência de estilo.
Receita P1 — Luz natural suave, com cara editorial
sujeito: uma tigela de frutas cítricas sobre uma toalha de linho
tonalidade: fotografia editorial de alimentos
referência de estilo: luz suave e difusa de janela vinda da esquerda, profundidade de campo rasa, visão equivalente a 50mm, cores naturais, altas luzes com queda suave, grão delicado
composição: vista de cima em três quartos, sujeito ligeiramente fora do centro
restrições: sem texto, sem adereços além das bordas do quadro, sem altas luzes estouradas
A direção da luz é a frase de maior alavancagem. Especificar fonte e direção ("luz suave e difusa de janela vinda da esquerda") produz resultados mais estáveis do que "luz bonita".
Receita P2 — Luz dura, nitidez de produto
sujeito: uma caixa de som sem fio preta fosca sobre uma superfície de concreto
tonalidade: fotografia de produto em estúdio
referência de estilo: uma única luz principal dura vinda da direita superior, bordas de sombra nítidas, detalhe limpo em nível macro, fundo cinza neutro, leve separação de contorno, sem dominante de cor
composição: centralizado, ao nível dos olhos, enquadramento quadrado
restrições: sem texto, sem reflexos de estúdio, sem poeira
Palavras de material são cruciais aqui — fosco, concreto, cinza neutro — porque o modelo infere a resposta da superfície a partir delas. Se o material não parecer certo, ajuste primeiro as palavras de material, depois a luz.
Receita P3 — Documental com luz ambiente
sujeito: uma barraca de feira noturna, o feirante arrumando os produtos
-tonalidade: fotografia documental de rua
referência de estilo: luz ambiente, temperatura de cor mista, grão visível, leve desfoque de movimento nas pessoas ao fundo, visão equivalente a 35mm, profundidade de campo mais profunda mas imperfeita
composição: espontânea, ao nível dos olhos, sujeito parcialmente enquadrado pela borda da barraca
restrições: sem sobreposição de texto, sem expressões posadas, sem iluminação de estúdio
Receitas documentais precisam de vocabulário permissivo: espontânea, luz ambiente, foco imperfeito. Sem isso, o modelo recai numa aparência polida e posada.
Receita P4 — Paisagem, compressão de teleobjetiva
sujeito: cumes de montanha em camadas ao nascer do sol
tonalidade: fotografia de paisagem
referência de estilo: compressão de teleobjetiva, névoa atmosférica crescente com a distância, sombras frias e altas luzes quentes, alto alcance dinâmico mas céu limpo, sem ruído aparente
composição: linhas de cumeada empilhadas horizontalmente, horizonte no terço inferior
restrições: sem texto, sem pessoas, sem artefatos de flare de lente
Tabela de consulta rápida de vocabulário
- Luz: luz difusa de janela, luz principal dura, separação de contorno, luz ambiente, temperatura de cor mista.
- Sensação de lente: profundidade de campo rasa, compressão de teleobjetiva, visão grande-angular, detalhe limpo em nível macro.
- Material: fosco, escovado, concreto, linho, resposta de reflexo especular versus difuso.
- Enquadramento: ao nível dos olhos, vista de cima em três quartos, fora do centro, posição do horizonte.
Servir receitas por uma API agregadora
Uma receita só é útil quando você consegue julgar se a saída corresponde à intenção. O erro que a maioria das equipes comete é avaliar o resultado como "bom" ou "ruim", em vez de perguntar qual slot falhou. Antes de olhar para a imagem, anote o que cada slot deveria produzir:
- Sujeito: o conteúdo literal — ele aparece e está descrito corretamente?
- Referência de estilo: o tratamento de superfície — paleta, linha, textura, características da luz.
- Tonalidade: o clima geral — calmo, ousado, editorial, espontâneo.
- Composição: onde cada elemento se posiciona no quadro.
- Restrições: os itens negativos — sem texto, sem gradientes, sem adereços extras.
Em seguida, compare linha a linha com a imagem. Um resultado com sujeito correto mas textura errada não é uma falha da receita, é uma falha da frase de textura. É justamente essa distinção que torna a iteração rápida.
A regra de variável única
Mude apenas um slot por execução e mantenha todo o resto fixo — incluindo os parâmetros e, quando houver suporte, a seed. Se você mudou duas coisas e a saída melhorou, não aprendeu nada reproduzível.
Um ciclo prático:
- Execute a receita como está. Salve a saída junto com o texto completo da receita e os parâmetros.
- Dê uma nota de aprovação/reprovação a cada slot conforme a intenção que você anotou.
- Escolha o slot com pior desempenho.
- Edite apenas esse slot — refine as palavras, adicione uma restrição ou remova frases contraditórias.
- Execute de novo. Compare lado a lado com a saída anterior.
- Quando um slot passar, congele aquela formulação e passe para o próximo slot com pior desempenho.
Identificar padrões de falha comuns
- Vazamento de restrição. Texto ou assinatura aparecem apesar da restrição "sem texto". A causa normalmente é uma frase de sujeito ou tonalidade que sugere tipografia, como "cartaz" ou "rótulo". Remova essa sugestão em vez de apenas repetir a palavra negativa.
- Média de estilos. Duas referências se misturam numa papa. Escolha uma referência dominante e rebaixe a outra a modificador.
- Conflito de slots. O slot de sujeito descreve o modo de renderização ("uma raposa em aquarela") enquanto o slot de estilo também descreve o modo de renderização. Não deixe a linguagem de renderização entrar no slot de sujeito.
- Excesso de especificação. Prompts longos entupidos com dezenas de adjetivos diluem cada um deles. Se uma frase não tem efeito mensurável, apague-a.
Construir uma biblioteca de receitas
Salve cada receita como texto estruturado, com número de versão, conjunto de parâmetros usados, seed quando fixada e um link para as suas saídas. Trate mudanças de receita como mudanças de código: registre o que mudou e por quê. Quando você fizer uma comparação A/B de duas receitas mais adiante, as diferenças devem ser apenas as que você pretendeu, e a seed e os parâmetros devem estar fixos para garantir uma comparação justa.
Mesmo com tudo fixo, um certo grau de variação é normal — trate a receita como uma linha de base reproduzível, e não como uma garantia exata bit a bit, e mantenha os logs de saída junto das receitas, para que as comparações permaneçam honestas.

Servir receitas por uma API agregadora
Assim que uma receita se estabiliza, ela deve ir para o código — e não ficar num documento compartilhado que sofre deriva. O objetivo é fazer do prompt um valor versionado que a sua aplicação monta, envia, registra e pode substituir sem reescrever nada.
Montar o prompt a partir dos slots
Guarde cada slot como um campo separado e concatene na hora do request. Isso permite que você mude um slot nos testes sem copiar o resto da string:
recipe = {
"id": "photo-p1-citrus",
"version": 3,
"subject": "uma tigela de frutas cítricas sobre uma toalha de linho",
"style": "luz suave e difusa de janela vinda da esquerda, profundidade de campo rasa, "
"cores naturais, grão delicado",
"tone": "fotografia editorial de alimentos",
"composition": "vista de cima em três quartos, sujeito ligeiramente fora do centro",
"constraints": "sem texto, sem altas luzes estouradas",
}
prompt = ". ".join(
[recipe["subject"], recipe["tone"], recipe["style"],
recipe["composition"], recipe["constraints"]]
)
O id e o version são o ponto crucial: toda imagem gerada deve ser rastreável até a revisão exata da receita que a produziu.
Passar parâmetros de forma consistente
Fixe os parâmetros que afetam a reprodutibilidade — tamanho, seed quando houver suporte e quaisquer controles de estilo ou intensidade expostos pelo modelo — num objeto de configuração por receita, em vez de espalhá-los por cada ponto de chamada. Numa comparação A/B, só o número da versão deveria mudar.
Rotear por uma API unificada
Envie os requests por um único endpoint compatível com OpenAI da HiAPI.ai, em vez de integrar cada fornecedor de modelo separadamente. Assim, quando o modelo por trás de recraft-v4-styles/text-to-image mudar, o código da sua receita permanece estável; e você pode testar a receita com outro modelo trocando o identificador do modelo — sem SDK novo, sem novo fluxo de autenticação, sem reescrever a lógica de montagem do prompt. Aponte o cliente para https://api.hiapi.ai/v1 e mantenha o versionamento das receitas no seu próprio código.
Registrar o que realmente importa
Para cada geração, registre o id e a versão da receita, a string de prompt resolvida, cada parâmetro, a referência da imagem retornada e uma linha de intenção. Esse log é o seu kit de testes A/B e também a pista de depuração quando uma atualização futura de modelo deslocar as saídas.
Copie e cole a receita como linha de base, itere um slot por vez e depois congele numa versão registrada, servida por meio do HiAPI.ai — é exatamente esse fluxo que transforma um prompt de sorte numa pipeline confiável.
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