Blogue

Guia de uso

Receitas de prompts de imagem-para-imagem para o Ideogram v4.5 voltadas a desenvolvedores

Prompts de edição prontos para copiar: fidelidade ao sujeito, substituição de fundo e preservação de texto

Nov 10, 2026
Imagem de capa com formas líquidas abstratas e planas sobrepostas, sobre um fundo preto tinta, salpicado por formas fluidas e em camadas em verde celadon e cinza ardósia.
Nesta página

Por que prompts de imagem-para-imagem precisam de uma estrutura diferente

Um prompt de texto-para-imagem descreve uma cena. Um prompt de imagem-para-imagem negocia com uma imagem que já existe. Essa diferença é estrutural, não cosmética, e é a principal razão pela qual prompts que funcionam muito bem do zero produzem resultados turvos assim que recebem uma imagem de referência.

Quando você descreve uma cena, cada token é aditivo: você está preenchendo uma tela em branco. Quando você edita uma imagem, cada token é ou uma instrução de preservação ou uma instrução de alteração, e o modelo precisa decidir qual é qual. Um prompt que diz apenas "mulher de jaqueta vermelha em um café" deixa o modelo livre para redesenhar o rosto, reprojetar o corte da jaqueta e reimaginar a sala inteira. Não há motivo algum para ele preservar qualquer coisa, porque você nunca pediu que preservasse.

A solução é escrever a edição como uma instrução de dois canais: um canal informa o que deve sobreviver à edição, o outro informa o que deve mudar. Tudo o que vem a seguir neste guia se apoia nessa divisão. O canal de preservação não é decoração — é o contrato que impede o modelo de rejogar detalhes que você já aprovou.

Antes de escrever qualquer prompt de edição, faça um teste mental rápido: leia seu rascunho e pergunte a si mesmo "se o modelo mudasse isto, o resultado estaria errado?". Se a resposta for sim, esse detalhe pertence ao canal de preservação. Se ele pertence ao canal de preservação mas você só o mencionou de passagem numa frase descritiva, mova-o para a frente e expresse-o no tom de uma instrução.

Duas consequências decorrem disso. Primeira, prompts de edição costumam ser mais curtos que prompts de geração, porque você não está mais redescrevendo o que a imagem de referência já mostra — você descreve a diferença. Segunda, eles são mais literais: frases imperativas ("keep", "do not change", "replace only") são mais confiáveis que adjetivos. Todas as receitas abaixo se baseiam nesses dois hábitos.

Um prompt, dois canais: o que a edição preserva e o que ela altera.

A receita base: anatomia de uma instrução de edição

Toda receita deste guia é uma variante do mesmo esqueleto. Aprenda o esqueleto e você poderá reconstruir qualquer receita de memória.

Os cinco slots

  1. Intenção da edição — uma frase que declara a operação e seu escopo ("Altere apenas o fundo desta foto de produto.").
  2. Cláusula de preservação — lista explícita do que não deve mudar (identidade, geometria, texto, cor, enquadramento).
  3. Cláusula de alteração — o que modificar, descrito com especificidade suficiente para ser acionável.
  4. Cláusula de estilo/fusão — como os novos elementos devem se fundir com os antigos (direção da luz, suavidade das sombras, perspectiva, granulação).
  5. Restrições — limites rígidos e exclusões (nenhum objeto novo, sem alterar texto, sem reenquadrar).

Um modelo de preenchimento

Edit intent: <operation> on <target region>.
Preserve: <subject identity>, <geometry/pose>, <text and layout>, <color and material>.
Change: <what to replace or add>, <how much of the frame it covers>.
Integrate: match <light direction>, <shadow behavior>, <perspective>, <film grain / noise>.
Constraints: do not <failure mode 1>; do not <failure mode 2>; keep <critical edge> clean.

A ordem importa mais do que você imagina. Colocar a cláusula de preservação antes da cláusula de alteração ancora o sujeito antes que o modelo comece a pintar a nova região, o que na prática reduz significativamente o desvio de identidade. Colocar a cláusula de fusão depois da cláusula de alteração mantém as instruções de fusão vinculadas ao objeto que está sendo fundido.

Mantenha a intenção da edição estreita

Um prompt, uma operação. "Troque o fundo e atualize a fonte do título" são duas edições, e o modelo frequentemente executa a mais difícil às custas da mais simples. Faça em duas passagens, alimentando a saída da primeira na segunda. As receitas de tipografia e texto mais adiante neste guia dependem desse padrão de encadeamento.

Torne os slots reutilizáveis

A forma como equipes obtêm reprodutibilidade é congelar a redação dos slots que raramente mudam — as cláusulas de preservação e as restrições — e editar apenas a cláusula de alteração e a cláusula de fusão por tarefa. Escreva essas strings congeladas uma vez, coloque-as em constantes compartilhadas, e seus prompts não vão variar entre autores diferentes. O restante deste guia fornece valores iniciais para cada família de slots.

A receita base é como uma corrente de blocos fluidos: cada slot dobra-se no próximo, da preservação às restrições.

Receitas de fidelidade ao sujeito

A fidelidade ao sujeito é o slot que a maioria das pessoas descreve de forma insuficiente. "Preserve o sujeito" é vago demais para vincular qualquer coisa; o modelo o interpreta como "preserve algo parecido com um sujeito". Nomeie as propriedades que importam para você.

Receita: rosto preservado, contexto trocado

Edit intent: change the setting around the person in this photo; the person is not the edit target.
Preserve: the person's facial identity, facial proportions, skin tone, hairline and hairstyle, expression, pose, and body proportions.
Change: the environment behind and around the person to <new scene>.
Integrate: relight the person's edges to match the new scene's <light direction> and <color temperature>; keep shadow softness consistent with the new environment.
Constraints: do not smooth, beautify, or re-synthesize the face; do not change the head angle; do not alter clothing cut or color.

A linha do not smooth or beautify vale a pena. Modelos fotográficos tendem por padrão a embelezar, e sem essa restrição uma substituição de fundo silenciosamente retorna uma pessoa com aparência diferente.

Receita: consistência de produto e embalagem

Edit intent: place the product from this image into a new scene.
Preserve: product silhouette, proportions, label placement, typography on the label, cap and seam geometry, material finish, and brand colors.
Change: the surface it rests on and the surrounding scene to <new setting>.
Integrate: match perspective and horizon; add a contact shadow and a plausible reflection on <surface>; match overall exposure to the new scene.
Constraints: do not redraw the label; do not add or remove product features; do not change the camera angle.

Para embalagens, o rótulo é a identidade. Se ele se deformar, a edição falha comercialmente mesmo que a renderização pareça boa.

Receita: continuidade de personagem e ilustração

Edit intent: keep the character exactly as drawn and change only their surroundings.
Preserve: character proportions, line weight, facial design, marking and pattern placement, outfit design, and palette.
Change: the background and props around the character to <new context>.
Integrate: keep the illustration style, stroke consistency, and shading language identical to the reference.
Constraints: do not add costume details; do not change the art style; do not alter character scale relative to the frame.

O que fazer quando a fidelidade ainda deriva

Se a identidade ainda derivar após duas tentativas, pare de reescrever a cláusula de alteração — o problema geralmente é de escopo. Recorte a imagem de referência mais perto ao redor do sujeito para que ele ocupe mais do quadro; ou reduza o tamanho da região que você está pedindo ao modelo para substituir. Problemas de fidelidade são frequentemente problemas de enquadramento disfarçados de prompt.

O mesmo núcleo, dois contextos líquidos diferentes: o sujeito fixo permanece igual enquanto as formas ao redor mudam.

Receitas de substituição de fundo

A substituição de fundo falha de duas maneiras típicas: halo ou franja nas bordas do sujeito, e iluminação da nova cena inconsistente com a luz original do sujeito. Ambos os casos são resolvidos com a cláusula de fusão, não com descrições mais detalhadas do novo fundo.

Receita: substituição de fundo de estúdio com bordas limpas

Edit intent: replace the background only; the subject remains untouched.
Preserve: the subject's outline down to fine edges — hair strands, fur, fabric edges, transparent or reflective parts.
Change: the background to <seamless backdrop / gradient / studio sweep>.
Integrate: light the backdrop independently of the subject; keep the subject's existing key light direction; do not add a colored spill onto the subject.
Constraints: no fringe or halo at the subject edge; no background color bleeding into hair or translucent materials; do not crop or rescale the subject.

Nomear explicitamente a franja é a linha de maior valor aqui. Sem ela, um halo tipo recorte é um resultado padrão muito comum em cabelo e embalagens translúcidas.

Receita: substituição de ambiente com correspondência de iluminação

Edit intent: replace the location around the subject.
Preserve: subject identity, pose, scale, and position in frame; existing shadow shape on the subject is the reference for light direction.
Change: the environment to <new location>, including depth cues appropriate to that location.
Integrate: derive the new light direction and color temperature from the subject's existing highlights; add environment contact shadows under the subject; match depth of field and grain to the reference.
Constraints: no duplicated light sources; do not introduce reflections that contradict the new scene; do not change the subject's cast shadow direction relative to the new light.

Dizer ao modelo para derivar a iluminação dos realces existentes é mais confiável do que descrever a iluminação em palavras. A imagem de referência já codifica a verdade; seu prompt só precisa apontar para ela.

Receita: edição de fundo localizada

Edit intent: modify only the region behind the subject below the shoulder line.
Preserve: everything above that line, including the subject and the existing upper background.
Change: the lower background to <new content>.
Integrate: continue the perspective and color grade of the untouched upper region seamlessly across the boundary.
Constraints: no visible seam; no change to subject edges; do not shift the subject.

Edições com escopo regional permitem que você evite rejogar um fundo que já está bom. Descreva a fronteira em linguagem espacial direta — o modelo a interpreta de forma mais consistente do que coordenadas percentuais.

Receitas para preservar tipografia e texto

Tipografia é onde um único prompt genérico mais vaza. O texto é a primeira coisa a derreter e a última que você nota até o cliente notar. Trate o texto como uma camada bloqueada e diga isso explicitamente.

Receita: pôster com tipografia bloqueada

Edit intent: change the imagery in this poster; the text layer is locked.
Preserve: every character of existing text, including exact spelling, capitalization, punctuation, font style, weight, size, line breaks, alignment, and position in the layout.
Change: the photographic or illustrative elements <describe region>.
Integrate: keep the same margins and grid; ensure the new imagery does not sit behind or overlap any text.
Constraints: do not re-render, re-typeset, or paraphrase any text; do not add new copy; do not change contrast between text and its immediate background.

A restrição do not paraphrase é importante: modelos às vezes "corrigem" o texto enquanto preservam sua aparência, o que é pior que uma corrupção óbvia, porque é difícil de detectar num relance.

Receita: edição de capturas de tela e ativos de UI

Edit intent: update visual styling of this interface asset without changing its content.
Preserve: all labels, numbers, icons' meaning, component positions, spacing, and reading order.
Change: <color theme / border radius / shadow depth> only.
Integrate: apply the change consistently across all matching components.
Constraints: do not add, remove, or reorder UI elements; do not alter any glyph; keep text legible at the original size.
Edit intent: place this branded asset into a new context.
Preserve: logo geometry, letterforms, clear space around the mark, and brand colors exactly.
Change: the surrounding composition to <new layout or scene>.
Integrate: match the new composition's perspective while keeping the logo flat and undistorted.
Constraints: do not redraw, restyle, or outline the logo; do not place the logo on a busy area that reduces contrast; do not crop the clear space.

Nota prática sobre execução encadeada

Se tanto a imagem quanto o texto precisam mudar, faça em duas passagens: primeiro bloqueie o texto e edite a imagem, depois edite a camada de texto separadamente e bloqueie a imagem. Prompts com múltiplas operações brigam entre si; a execução em passos não. Na segunda passagem, mantenha as cláusulas de preservação da primeira passagem intactas, para que a edição de texto não desfaça o trabalho de imagem.

Construindo a lista de itens negativos

Instruções negativas em imagem-para-imagem não são um segundo prompt — são uma lista de regressão. Mantenha-a curta, mantenha-a específica aos modos de falha que você já observou de fato, e anexe-a ao slot de restrições do modelo, não como um adendo posterior.

Modos de falha recorrentes

  • Desvio de identidade — rosto ou produto sutilmente re-sintetizado. Negativo: do not alter facial features; do not smooth or beautify skin; do not redraw the product label.
  • Artefatos de borda — halo, franja, máscara serrilhada em cabelo ou materiais translúcidos. Negativo: no halo or fringe at subject edges; no background bleed into hair.
  • Incompatibilidade de iluminação — nova cena inconsistente com os realces ou sombras do sujeito. Negativo: no conflicting light directions; no duplicated shadows; no colored spill on the subject.
  • Texto corrompido — texto derretido, escrito errado ou discretamente reescrito. Negativo: do not re-typeset or paraphrase any text; do not add copy.
  • Expansão de layout — elementos se movem, margens mudam, componentes se reordenam. Negativo: do not move, resize, or reorder existing elements.
  • Vazamento de escopo — o modelo edita regiões que você não pediu para editar. Negativo: change only <region>; leave the rest of the frame untouched.
  • Substituição de estilo — fotos viram ilustrações, ou ilustrações planas ganham sombreamento realista. Negativo: do not change the medium or rendering style.

Mantenha a lista disciplinada

Três a seis itens negativos por prompt é a faixa prática. Uma lista negativa excessivamente longa dilui a atenção e pode suprimir detalhes legítimos, então remova qualquer item cujo retrocesso você ainda não observou pessoalmente. Guarde a lista como uma lista compartilhada, deixe cada receita referenciar o subconjunto de que precisa, e versione-a — quando um novo modo de falha aparece na revisão, ele é adicionado uma vez e herdado em toda parte.

Outro hábito que vale cultivar: quando uma edição falha, registre a falha como um candidato a item negativo antes de reescrever o prompt positivo. Equipes que fazem isso convergem para prompts estáveis mais rápido do que as que reescrevem do zero a cada vez.

Testando e iterando receitas em código

Uma receita de prompt só é um ativo quando é executável. Um loop leve é suficiente: mantenha a receita fixa, mude um slot, gere, compare, aperte.

Estruturando a receita como dados

Mantenha os slots congelados como constantes e os slots variáveis como parâmetros. Assim, "testar" significa apenas parâmetros diferentes em vez de strings diferentes montadas à mão.

RECIPE = {
  "intent": "Change only the background of this product photo.",
  "preserve": "product silhouette, label typography, brand colors, camera angle",
  "integrate": "match the new scene's light direction and add a contact shadow",
  "constraints": [
    "do not redraw the label",
    "no fringe at the product edge",
    "do not change the camera angle",
  ],
}

def build_prompt(recipe, change, negatives):
    return (
        f"Edit intent: {recipe['intent']}\n"
        f"Preserve: {recipe['preserve']}.\n"
        f"Change: {change}.\n"
        f"Integrate: {recipe['integrate']}.\n"
        f"Constraints: {'; '.join(recipe['constraints'] + negatives)}."
    )

O ciclo de iteração

  1. Congele a imagem de referência e todos os slots, exceto o que está sendo testado.
  2. Mude uma coisa só — geralmente a cláusula de alteração ou um único item negativo.
  3. Gere as variantes na mesma chamada de imagem-para-imagem, para que a única diferença seja o texto do prompt.
  4. Compare item por item contra as cláusulas de preservação: identidade, geometria, texto, iluminação. Dê nota de aprovado/reprovado por item, não "parece bom".
  5. Revise a redação e execute novamente. Só promova uma redação a receita compartilhada depois que ela passar duas vezes seguidas.

O que registrar

Armazene o prompt completo, a versão da receita, o identificador da imagem de referência e o resultado de aprovado/reprovado de cada item de preservação. Quando alguém perguntar por que a redação de uma receita está estranha, esse registro é a resposta — e quando o modelo ou o comportamento do endpoint mudar, você pode fazer diff contra a última execução boa conhecida em vez de adivinhar.

Entregue receitas, não prompts

Um prompt é descartável; uma receita com slots nomeados e uma lista negativa é um ativo de equipe. Versione-a, revise suas mudanças como revisa código, e mantenha o histórico de alterações. É exatamente isso que torna a edição imagem-para-imagem reproduzível entre pessoas e ao longo do tempo.

Quando você estiver pronto para conectar essas receitas em um pipeline real, o endpoint de imagem-para-imagem do HiAPI.ai aceita a mesma estrutura de prompt e cobra conforme o seu uso, com a taxa atual disponível no painel de preços.

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