Receitas de prompts de imagem para imagem do Seedream 5.0 Lite: 3 casos de edição prontos para copiar e colar, com resultados reais de antes e depois

Gerar uma imagem do zero já é um problema resolvido. O trabalho mais difícil — e o que realmente aparece no fluxo de produção — é a edição: mudar apenas este ponto e manter todo o resto. O seedream-5.0-lite/image-to-image foi criado exatamente para isso: edição baseada em instruções, com suporte a até 14 imagens de referência, mantendo as áreas não editadas intactas.

Este artigo traz três receitas de edição prontas para copiar e colar, cobrindo três tarefas de edição que realmente importam: uma edição local precisa, uma composição com múltiplas imagens de referência e uma substituição de texto. Cada imagem de "depois" abaixo é o resultado da primeira geração com o prompt mostrado — cada edição foi executada uma única vez, sem repetir, sem escolher a melhor. As imagens de "antes" foram geradas com o modelo irmão de texto para imagem, então você pode reproduzir o artigo inteiro de ponta a ponta por cerca de um quarto do preço.

Se você quer conhecer as capacidades de t2i do modelo — pôsteres, menus, renderização de texto — já cobrimos isso nas seis receitas de prompts t2i. Aqui é tudo sobre edição.

Configuração em 30 segundos

O endpoint de edição roda na API de tarefas assíncronas da hiapi: crie uma tarefa com a URL da sua imagem de referência, consulte a tarefa e baixe o resultado.

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/image-to-image",
    "input": {
      "prompt": "YOUR EDIT INSTRUCTION",
      "image_urls": ["https://your-host.com/input.jpg"],
      "aspect_ratio": "3:2",
      "resolution": "2K"
    }
  }'
# → {"data": {"taskId": "..."}}

curl https://api.hiapi.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $HIAPI_API_KEY"
# poll until "status": "success", then download output[0].url

Quatro coisas que vale saber antes da primeira edição:

• image_urls, aspect_ratio e resolution são todos obrigatórios. Se faltar qualquer um deles, a API retorna 400 e aponta o campo ausente (image_urls: missing required field "image_urls"; …). As URLs precisam ser acessíveis publicamente.
• resolution aceita apenas "2K" ou "4K". Enviar "1K" retorna 400: resolution: value must be one of '2K', '4K' — mesma regra do endpoint t2i. Todas as imagens deste artigo são 2K.
• Faça aspect_ratio corresponder à imagem de entrada. Todas as nossas imagens de referência são 3:2, então toda edição solicita saída 3:2. Brigar com a geometria da imagem de entrada só desperdiça sua edição em recortes.
• As URLs de saída expiram. Baixe o arquivo imediatamente após o sucesso da tarefa; não faça hotlink.

O preço é fixo em US$ 0,035 por imagem, independentemente da quantidade de imagens de referência — veja a tabela de preços. Reserve de um a dois minutos de polling por edição 2K e não espere resposta síncrona.

Receita 1: edição local precisa

Tarefa: mudar o material e a cor de um objeto sem tocar no resto da cena. É a edição mais comum para variantes de produto — e é justamente onde a maioria dos modelos de edição redesenha silenciosamente a cena inteira.

Imagem de entrada, gerada por t2i:

Instrução de edição:

Change the matte white ceramic mug into a deep cobalt blue glazed mug
with a glossy reflective finish, keep the steam, the oak desk, the open
notebook, the fountain pen, the succulent, the lighting and the camera
angle exactly unchanged, photorealistic

Primeira geração:

A caneca passou de branco fosco para azul-cobalto brilhante — incluindo os novos reflexos especulares — enquanto o caderno, a ponta da caneta, a suculenta e a luz da janela permaneceram no lugar. Observe a estrutura de três partes do prompt: nomeie o alvo ("the matte white ceramic mug"), descreva a mudança ("deep cobalt blue glazed, glossy") e depois liste item por item o que não pode se mover. Essa lista de preservação não é enfeite; é justamente o que fixa o resto do quadro. Detalhes que o modelo renderiza novamente (como fios de vapor) diferem em nível de pixel mesmo com o layout intacto — então planeje a tolerância de acordo.

Receita 2: composição com múltiplas imagens de referência

Tarefa: pegar o sujeito de uma imagem e colocá-lo na cena de outra. O seedream-5.0-lite aceita até 14 imagens de referência em uma única chamada; aqui usamos duas.

Referência 1 — o sujeito, foto de produto em estúdio:

Referência 2 — a cena:

Instrução de edição — observe os ordinais, é assim que você referencia cada imagem:

Take the leather backpack from the first image and place it on the flat
granite boulder in the campsite scene from the second image, leaning
naturally at a slight angle, relit to match the warm golden-hour sunlight
with a soft shadow falling across the rock, keep the stone fire ring,
pine forest and mountain peaks unchanged, photorealistic composite

Primeira geração:

A mochila mantém os fechos, as costuras e os detalhes das alças da foto de estúdio, mas a iluminação mudou da luz difusa de estúdio para um sol quente e direcional, projetando uma sombra de contato no granito. O anel de pedras da fogueira, a linha de árvores e os picos permanecem intactos. Em qualquer composição com múltiplas referências, espere duas coisas: o modelo vai ajustar levemente a pose do sujeito para encaixá-lo naturalmente na cena (nossa mochila ficou um pouco mais inclinada do que na foto de estúdio), e vai renderizar novamente a iluminação globalmente, em vez de colar pixels. Se você precisa de pixels exatos do sujeito, esta não é a ferramenta certa — o que você obtém é uma composição sem sinais visíveis de colagem.

Receita 3: substituição de texto

Tarefa: trocar o texto de um letreiro sem reconstruir a fachada inteira. A força do Seedream é a renderização de texto, e essa capacidade se estende ao endpoint de edição.

Imagem de entrada:

Instrução de edição:

Replace the text on the wooden sign above the door so it reads
'BAKERY CORNER' in the same gold serif lettering style and size, keep
the sign shape and wood texture, the brick facade, the glowing window,
the olive trees and the overcast lighting exactly unchanged,
photorealistic

Primeira geração:

"BAKERY CORNER" saiu de primeira com grafia correta, espaçamento correto e a mesma fonte dourada com serifa. A camada de tijolos, as oliveiras e a luz quente da janela permaneceram intactas. Cite a string exata que você quer ('BAKERY CORNER'), ancore-a a uma posição ("on the wooden sign above the door") e exija o estilo original ("same gold serif lettering style and size") — a mesma disciplina de citação que deu 16/16 strings corretas nos nossos testes de t2i também se aplica à edição.

O padrão dos prompts de edição

As três receitas são a mesma frase, só mudam os substantivos:

1. Alvo — nomeie o objeto que você vai editar com um atributo identificador: "the matte white ceramic mug", "the text on the wooden sign above the door".
2. Mudança — especifique o novo estado: material, cor, acabamento de superfície, texto exato citado, posição na cena.
3. Lista de preservação — liste item por item o que deve permanecer: objetos, iluminação, ângulo de câmera. Termine com "exactly unchanged". A lista de preservação é a parte de maior alavancagem do prompt; cada substantivo que você lista é algo que o modelo não vai improvisar.
4. Use ordinais para múltiplas referências — com vários image_urls, referencie com "the first image", "the second image". A ordem no array é a ordem no prompt.
5. Combine a geometria — solicite a mesma proporção da entrada e lembre-se de que resolution aceita apenas 2K ou 4K.

E um aviso honesto: edição é rerenderização, não máscara do Photoshop. As áreas que o modelo toca (vapor, reflexos, bordas de folhagem) variam sutilmente entre antes e depois. Essas receitas entregam estabilidade de layout, identidade e estilo — não igualdade bit a bit nas áreas fora da edição.

Reproduza estas edições em Python

import os, time, requests

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"}

task = requests.post(API, headers=HEADERS, json={
    "model": "seedream-5.0-lite/image-to-image",
    "input": {
        "prompt": "Change the matte white ceramic mug into a deep cobalt "
                  "blue glazed mug with a glossy reflective finish, keep "
                  "the steam, the oak desk, the open notebook, the fountain "
                  "pen, the succulent, the lighting and the camera angle "
                  "exactly unchanged, photorealistic",
        "image_urls": ["https://your-host.com/desk-mug.jpg"],
        "aspect_ratio": "3:2",
        "resolution": "2K",
    },
}).json()
task_id = task["data"]["taskId"]

while True:
    t = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
    if t["status"] in ("success", "fail"):
        break
    time.sleep(5)

if t["status"] == "success":
    url = t["output"][0]["url"]  # expires — download immediately
    open("edited.jpg", "wb").write(requests.get(url).content)

Para as receitas 2 e 3, basta trocar prompt e image_urls. Para se aprofundar no ciclo de vida da tarefa — tratamento de erros, timeouts, webhooks — veja o tutorial da API de imagem para imagem.

Perguntas frequentes

Quantas imagens de referência posso enviar? Até 14 em um único array image_urls, todas cobradas como uma edição de US$ 0,035. Na prática, duas ou três referências bem escolhidas superam dez referências vagas — cada imagem extra dilui a atenção dada a cada uma.

Ele mantém rostos/produtos consistentes entre edições? Para objetos, a identidade é bem preservada (nossa mochila manteve ferragens e costuras após a rerenderização completa de iluminação). Para trabalhos de produto em que o pixel importa — padrões exatos de rótulo, texto regulatório —, valide a saída imagem por imagem; o modelo rerenderiza em vez de aplicar máscara. Para um exemplo de produção, veja como geramos imagens de produto de e-commerce com este endpoint.

Por que minha chamada retorna 400? Três causas comuns: campos obrigatórios ausentes (image_urls, aspect_ratio e resolution são todos obrigatórios), resolution definido com valor diferente de 2K/4K, ou URL de imagem de referência não acessível publicamente.

2K ou 4K? Use 2K para iterar — todas as imagens deste artigo são 2K e o texto da receita 3 ainda fica nítido. Reserve o 4K para ativos finais de impressão/key visual; o preço por imagem é o mesmo, mas a geração demora mais.

---

Três edições, três primeiras gerações, US$ 0,035 cada. O padrão — alvo, mudança, lista de preservação — é deliberadamente entediante: prompts entediantes são prompts reproduzíveis. Pegue uma API key, aponte a página do modelo seedream-5.0-lite/image-to-image para sua própria imagem de "antes" e comece pela receita 1 — a substituição de um único objeto é a forma mais rápida de descobrir exatamente quanto a lista de preservação consegue fixar.