Blogue

Guia de uso

Receitas de prompts do Z-Image: prompts prontos para copiar e colar para geração de texto em imagem com o Turbo

Estruturas de prompts reutilizáveis para cena, estilo e texto na imagem — com guia de pesos e lista negativa

Nov 17, 2026
Imagem de capa do guia de receitas de prompts do Z-Image: sobre um fundo quase preto, uma malha de pontos verde-menta que se adensa gradualmente da esquerda para a direita, com um aglomerado de pontos em ciano-escuro no canto inferior direito.
Nesta página

Por que receitas de prompts superam prompts descartáveis

A maioria das pessoas escreve prompts como escreve mensagens de commit: rápido, uma única vez, e nunca mais olha. O prompt funciona ou não funciona, a imagem é salva em algum lugar, e o conhecimento de por que ela deu certo se dissolve. Na próxima vez que você precisar de uma imagem parecida, começa do zero.

Uma receita de prompt é o hábito oposto. Em vez de tratar o prompt como uma string opaca, você o decompõe em blocos nomeados — sujeito, cena, estilo, texto na imagem e uma lista negativa curta — e mantém esses blocos estáveis entre gerações. Quando quiser uma imagem nova, não reescreve o prompt: substitui o conteúdo de um bloco.

Para desenvolvedores, isso tem três implicações práticas:

  • Reprodutibilidade. Uma receita é um template parametrizado. Duas renderizações com a mesma receita e os mesmos valores de slot devem sair como irmãs, não como estranhas. Isso torna problemas de regressão visíveis.
  • Atribuibilidade. Quando a saída sai errada, a estrutura de blocos mostra onde olhar. Iluminação estranha? Verifique o bloco de cena. Letreiro ilegível? Verifique o bloco de texto. Um prompt monolítico não oferece esse ponto de apoio.
  • Reúso entre projetos. Raramente uma necessidade de asset se resume a uma única peça. Você vai querer a mesma linguagem visual atravessando uma imagem principal, um conjunto de miniaturas e um cartão social. Receitas escalam; prompts descartáveis são copiados e colados até se degradarem.

A mudança de mentalidade é pequena, mas transforma a forma de iterar: em vez de "tentar qualquer coisa", você começa a executar variantes controladas. O restante deste artigo monta essa caixa de ferramentas — primeiro a anatomia da receita, depois os slots de cena e estilo, em seguida as formulações para renderizar texto, depois a disciplina de pesos e prompts negativos, então o loop de comparação justa e, por fim, como integrar receitas validadas às chamadas de geração.

O prompt é dividido em blocos reutilizáveis — sujeito, cena, estilo, texto, negativo — e recomposto em uma única requisição de geração.

A anatomia de uma receita Z-Image

Antes de copiar qualquer prompt, ajuda entender para que serve cada parte. Uma receita Z-Image duradoura tem cinco slots. Você não precisa preencher os cinco toda vez, mas deve saber quais deixou vazios.

Slot 1: sujeito

O que está na imagem, dito de forma direta. Uma ou duas locuções nominais. Resista ao impulso de adjetivar aqui — adjetivos que descrevem como o sujeito parece pertencem ao bloco de estilo, não ao de sujeito. Misturar os dois dificulta substituições posteriores.

Slot 2: cena

Onde o sujeito está, que horas são, o que o ambiente está fazendo. Esse bloco carrega a maior parte da pressão de composição. Ele deve descrever o local, as condições de iluminação e a relação espacial entre sujeito e fundo.

Slot 3: estilo

O tratamento visual: meio, características de renderização, comportamento de cor, época, nível de detalhe. Este é o bloco que você deve conseguir trocar inteiro sem tocar nos demais.

Slot 4: texto na imagem

Qualquer texto que precise aparecer dentro da imagem, junto com sua posição e aparência. Esta parte ganha uma seção própria porque é o slot que as pessoas mais deixam implícito — e o que mais falha.

Slot 5: lista negativa

Uma lista curta e reutilizável do que você vê repetidamente e não quer. Ela deve estar atrelada a falhas observadas, não a suposições.

O template de montagem

Escrita como esqueleto, a receita fica assim:

[subject] in [scene], [style], text: "[string]" placed [position] rendered as [typographic look]
negative: [short list]

O valor está nos colchetes. Cada colchete é um eixo independente. Se você muda o bloco de estilo e a composição muda junto, aprendeu algo real sobre como os blocos interagem — e pode registrar isso. Se muda tudo de uma vez, não aprende nada reutilizável.

Há também uma disciplina que vale adquirir cedo: guarde suas receitas em arquivos de texto simples, com os slots rotulados. Quando uma renderização surpreender, você pode comparar a receita com a versão anterior em vez de tentar lembrar o que digitou.

Estrutura de palavras-chave para cena e estilo

Cena e estilo são os dois blocos que mais costumam colapsar em um caldo confuso. Mantê-los estruturalmente separados é o hábito de maior alavancagem deste artigo.

Organizando o bloco de cena

Descrições de cena ficam mais reutilizáveis se você responder sempre às mesmas perguntas na mesma ordem:

  1. Tipo de local — interno/externo e que tipo de espaço (estúdio, rua, floresta, corredor).
  2. Condições de iluminação — direção e textura (luz lateral suave, luz superior dura, difusão de dia nublado, uma única lâmpada prática).
  3. Pistas de profundidade — o que está perto, o que está longe, se o fundo é poluído ou limpo.
  4. Atmosfera — névoa, poeira, chuva, imobilidade. Opcional, mas estabiliza o clima.

Responder nessa ordem fixa significa que dois blocos de cena podem ser comparados diretamente. Se você varia a ordem das frases entre execuções, não consegue saber se a mudança na saída veio da nova redação ou da nova ordem.

Organizando o bloco de estilo

Descritores de estilo se dividem em famílias. Escolha no máximo um ou dois por família, em vez de empilhar dez adjetivos da mesma família:

  • Meio — fotografia, ilustração, renderização 3D, gravura, pintura.
  • Características de renderização — nítido, foco suave, granulado, alto contraste, chapado.
  • Comportamento de cor — dessaturado, saturado, monocromático, deslocado para quente, deslocado para frio.
  • Época ou categoria de referência — gravura modernista de meados do século, editorial moderno, futurismo retrô. Mantenha genérico; nomes de artistas específicos tendem a produzir resultados instáveis.

Trocar de estilo sem reconstruir

Depois que cena e estilo viram slots independentes, explorar estilo fica barato. Fixe sujeito e cena na linha de base e rotacione apenas o bloco de estilo:

subject:  a ceramic watering can
scene:    on a concrete ledge, soft window light from the left, shallow depth, clean background
style A:  photograph, crisp, muted color
style B:  illustration, flat, saturated color
style C:  3D render, soft-focus, cool-shifted

Três renderizações, uma variável, uma conclusão que você consegue de fato enunciar: qual tratamento combina com o seu projeto. Note que o bloco de cena permanece idêntico — é isso que torna a comparação válida. Se você também muda a iluminação, está apenas adivinhando.

Uma dica prática: mantenha uma pequena biblioteca de blocos de cena já validados (uma configuração de luz de estúdio, uma de luz do dia externa, uma de lâmpada prática interna). A maioria dos projetos precisa de dois ou três ambientes recorrentes, não de vinte.

Formulações que fazem o texto realmente ser renderizado

Texto na imagem é onde prompts vagos falham de forma mais evidente. Frases genéricas de estilo como "um pôster com um título" fazem o modelo inventar o texto, a posição e a fonte — e normalmente ele inventa mal. A solução é parar de esperar e começar a especificar.

Toda solicitação de texto precisa de três coisas

  1. Conteúdo — a string exata, entre aspas. Não uma descrição da string.
  2. Posição — onde ela fica no quadro e seu tamanho relativo.
  3. Aparência tipográfica — peso, caixa e estilo (sans-serif em negrito, serifada leve, manuscrita, letra de estêncil).

Uma solicitação mal especificada fica assim:

a storefront with a sign above the door

Uma solicitação estruturada fica assim:

a storefront with a sign above the door, text: "OPEN LATE" centered on the signboard, bold uppercase sans-serif, high contrast against the board

A segunda versão não garante sucesso, mas dá ao renderizador um alvo. Quando falha, a falha é diagnosticável: a string estava errada, a posição estava errada ou a fonte estava errada?

Padrões de redação que resistem

  • Cite a string exata. Coloque o texto literal entre aspas retas para que ele seja lido como conteúdo, não como adjetivo de estilo.
  • Declare a posição em relação ao objeto, não em relação ao quadro — "centralizado no letreiro" é mais estável que "no meio da imagem".
  • Descreva o suporte. Letreiro, etiqueta, lombada, tela. Texto em uma superfície bem definida renderiza de forma mais confiável do que texto flutuando no espaço.
  • Mantenha as strings curtas. Frases longas convidam a renderizações parciais e preenchimento inventado. Se você precisa de um parágrafo inteiro, divida em várias renderizações ou aceite um design em que só o título é texto real.
  • Diga o que o texto não é, se você vê repetidamente palavras inventadas extras: entradas negativas como extra words, gibberish text costumam ser mais eficazes do que se repetir no prompt positivo.

Quando o texto ainda não renderiza

Se uma string curta em uma superfície clara falha depois de duas ou três tentativas de redação, o problema normalmente está na cena, não no bloco de texto. Fundos poluídos, perspectivas extremas e efeitos atmosféricos densos competem com a legibilidade. Simplifique primeiro o bloco de cena — achate o fundo, reduza o ângulo — antes de empilhar mais instruções de texto.

Esquerda: uma solicitação de texto mal especificada permanece dispersa. Direita: ao indicar conteúdo, posição e estilo, a mesma granulação se organiza em estrutura.

Pesos e prompts negativos sem adivinhação

Ênfase e prompts negativos são as duas alavancas que as pessoas puxam primeiro e entendem por último. Ambas são úteis e ambas erram da mesma forma: acumulam-se como folclore em vez de evidência.

O hábito dos pesos

  • Comece sem peso. Faça a receita funcionar na linha de base antes de adicionar qualquer ênfase. Um prompt que só funciona com metade das frases ponderadas é um prompt frágil.
  • Reforce o bloco que está com desempenho ruim, não o prompt inteiro. Se o estilo está sendo ignorado, normalmente é a frase de estilo que precisa de ênfase — não cada adjetivo da string.
  • Mude um peso por iteração. Reforce dois ao mesmo tempo e você não saberá qual funcionou.
  • Registre o que você reforçou e por quê. Três semanas depois, um peso sem comentário é indistinguível de um erro de digitação.

Algumas interfaces expõem pesos como sintaxe dentro do prompt; outras aplicam por parâmetro separado. De qualquer forma, a disciplina é a mesma: uma ênfase é uma hipótese, e você deve ser capaz de dizer que resultado a refutaria.

O hábito dos prompts negativos

Trate sua lista negativa como um artefato pequeno e versionado, ligado a falhas recorrentes — não como um aterro sanitário.

  • Só adicione uma entrada depois de ver a falha pelo menos duas vezes. Uma renderização ruim é apenas ruído.
  • Nomeie a falha especificamente. blurry text e gibberish text são acionáveis; bad quality não é.
  • Limite o comprimento da lista. Se ela passar de cerca de doze itens, provavelmente o prompt positivo está mal especificado e você está tratando sintomas.
  • Pode durante execuções comparativas. Se remover uma entrada não muda nada em várias renderizações, ela é peso morto — corte.
  • Mantenha uma lista canônica por projeto. Usar listas negativas diferentes em prompts diferentes torna comparações entre prompts sem sentido.

Para trabalhos com muito texto, uma lista negativa útil costuma se estabilizar em poucas entradas recorrentes: palavras extras indesejadas, glifos distorcidos, objetos duplicados e alguns artefatos específicos do tipo de cena. É isso. A lista é curta porque foi escolhida a dedo, não porque você é tímido.

Comparando saídas reais do jeito certo

Toda afirmação neste artigo é uma hipótese inicial, não uma lei. Receitas Z-Image devem ser validadas contra as suas próprias renderizações, e comparações descuidadas confirmam alegremente uma conclusão errada.

Regras para uma comparação justa

  1. Fixe uma linha de base. Escolha uma variante de receita e re-renderize-a ao lado de cada candidata, para que você veja sempre base e mudança, e não mudança e memória.
  2. Mude um slot por execução. Trocar o estilo tudo bem; estilo mais iluminação mais uma nova entrada negativa não é comparação, é redesenho.
  3. Renderize mais de uma vez. Geração tem variância. Renderizar cada variante uma única vez pode fazer uma frase não confiável parecer decisiva.
  4. Julgue contra critérios explícitos. Decida antes de renderizar o que "melhor" significa — legibilidade do texto, precisão da cena, consistência de estilo. Critérios vagos produzem conclusões vagas.
  5. Registre a receita ao lado da saída. Uma imagem sem prompt é apenas curiosidade.

Um loop leve

Para desenvolvedores, um loop viável é este:

  • Mantenha a melhor receita atual como baseline.
  • Rascunhe uma variante que altera apenas um bloco.
  • Renderize as duas algumas vezes com as mesmas configurações.
  • Compare lado a lado, no mesmo tamanho — não em sequência, nem em níveis de zoom diferentes.
  • Promova a variante a linha de base ou descarte-a e anote o motivo.

As variantes descartadas são as mais valiosas. Elas provam que as frases que você queria muito adicionar não ajudaram, mantendo sua próxima montagem de receita enxuta.

O que registrar

Para cada receita sobrevivente, registre: os cinco slots, a lista negativa, qualquer coisa que você tenha ponderado e os critérios pelos quais ela passou. Esse registro é a receita. A string do prompt em si é só metade — a outra metade é saber contra o que ela foi validada.

Adaptando receitas via API

Depois que uma receita sobrevive à comparação, o passo final é torná-la chamável. O objetivo é preservar a estrutura de blocos ao longo de toda a requisição, para que os slots que você ajustou manualmente se tornem parâmetros no código.

Dos slots ao código

Uma receita mapeia de forma limpa para um construtor de requisições: um variável por slot, montadas em ordem fixa, com a lista negativa e quaisquer pesos passados junto. A propriedade importante é que mudar o estilo significa mudar uma variável — não editar strings em um literal gigante.

recipe = {
    "subject": "a ceramic watering can",
    "scene": "on a concrete ledge, soft window light from the left, shallow depth, clean background",
    "style": "photograph, crisp, muted color",
    "text": None,
}

prompt = "{subject} in {scene}, {style}".format(**recipe)

Quando você adiciona texto na imagem, ele é inserido como um fragmento separado, em vez de espalhado pela descrição da cena. Isso mantém a estrutura requisitável e comparável.

Mantendo a disciplina no código

Alguns hábitos passam da iteração manual para o uso programático:

  • Versione as receitas. Armazene-as como dados com identificador de revisão, para que regressões de saída possam ser rastreadas até uma mudança de receita, em vez de adivinhadas.
  • Registre o prompt completo a cada renderização. A string montada, a lista negativa e quaisquer pesos. Depurar sem isso é arqueologia.
  • Faça comparações em lote com intenção. Se estiver gerando variantes, mantenha um único eixo variável por lote, como fazia manualmente.
  • Valide após integrar. Uma receita que parecia boa em algumas renderizações manuais merece uma verificação um pouco maior depois de automatizada — a variância fica mais clara em volume.

O HiAPI.ai expõe o Z-Image por meio de uma interface unificada, então os detalhes de integração — campos de requisição, parâmetros de peso e tratamento de resposta — estão na página do modelo: consulte Z-Image para a referência atual de integração. Comece com uma receita validada, conecte-a e deixe o loop de comparação mostrar quando uma mudança vale a pena manter.

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