Guia da API de imagem para imagem do GPT Image 2

A geração de texto para imagem começa do zero.Imagem para imagem parte do material que você já tem — uma foto de produto em fundo branco, uma imagem de marca, uma foto de referência — e a transforma: novo fundo, nova iluminação, cenário diferente, reestilização. É o fluxo de trabalho ideal para equipes que já possuem seu próprio acervo de imagens e precisam de variações, não de ideias totalmente novas. Este guia apresenta a API GPT Image 2 imagem para imagem no hiapi, com dois pares reais de antes e depois, a forma exata de chamada e os parâmetros.

O ponto mais notável: no hiapi, gpt-image-2/image-to-image custa $0 por chamada. Você pode testar trocas de fundo e reestilizações repetidamente de graça, o que o torna a escolha natural antes de considerar qualquer nível pago.

Chamada: prompt + input_urls

Imagem para imagem tem o mesmo ciclo de vida de tarefa que outras tarefas no hiapi — POST /v1/tasks, polling ou callback, download. A única parte nova é input_urls: a imagem na qual você quer que o modelo trabalhe.

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2/image-to-image",
    "input": {
      "prompt": "Place this product on a dark slate surface with dramatic side lighting",
      "input_urls": ["https://static.hiapi.ai/blog/gpt-image-2-product-image-api/white-bg-packshot.jpg"],
      "aspect_ratio": "1:1"
    }
  }'

Campo	Tipo	Obrigatório	Descrição
prompt	string	Sim	O que deve ser alterado
input_urls	string[]	Sim	A imagem de origem a ser transformada
aspect_ratio	enum	Não	Proporção da saída
resolution	enum	Não	1K / 2K / 4K

Imagem de origem

As duas transformações abaixo partem da mesma foto comum de catálogo de produto em fundo branco — um coador de café cerâmico branco, sobre um fundo branco sem emendas:

Transformação 1: trocar o fundo e a iluminação

O mesmo produto, com tratamento de estúdio dramático — ardósia escura, luz lateral marcante, um fio de vapor. Esta foto de fundo branco vira uma imagem principal de nível editorial sem precisar de nova sessão fotográfica.

Place this exact white ceramic pour-over dripper on a dark slate stone surface
with dramatic side lighting and a soft steam wisp, moody editorial product
photography, keep the product shape and color unchanged.

• Modelo: gpt-image-2/image-to-image · aspect_ratio: 1:1 · ID da tarefa: tk-hiapi-01KVQK47VS7W1BCS9FCDTEX9XP · Custo: $0
• O que copiar: a frase "keep the product shape and color unchanged" é decisiva — ela ancora o sujeito, fazendo o modelo reestilizar o cenário, não o produto.

Transformação 2: inserir em um cenário

A mesma imagem de origem, com outra intenção — inserir o produto em um cenário de estilo de vida para a imagem principal da página inicial.

Place this exact white ceramic pour-over dripper on a wooden cafe counter with
a blurred warm cafe interior behind it, morning light, lifestyle product
photography, keep the product shape and color unchanged.

• Modelo: gpt-image-2/image-to-image · aspect_ratio: 4:3 · ID da tarefa: tk-hiapi-01KVQK75691SE3XJ1RP31JPQAE · Custo: $0

Quando fazer upgrade para o nível Pro

O nível gratuito gpt-image-2/image-to-image é adequado para exploração e para a maioria das edições. Quando os resultados renderizados precisam ter estabilidade de produção e você precisa inserir 1–5 imagens de referência de uma vez — composição, consistência entre múltiplos ângulos, materiais críticos de marca —, existe um nível gpt-image-2-image-to-image-pro criado para essa confiabilidade, ao custo de $0.40. Comece pelo gratuito e faça upgrade apenas quando a necessidade exigir.

Para fluxos de trabalho de edição em múltiplas rodadas (editar iterativamente ao longo de várias chamadas), consulte Edição em múltiplas rodadas do GPT Image 2. Pronto para transformar seu próprio acervo? Abra a página do modelo GPT Image 2 imagem para imagem.