Introdução
GPT Image 2 Edição de imagem aplica o modelo gpt-image-2 da OpenAI às imagens que você já tem. Dê a ele de uma a dez imagens de origem e uma instrução: mude uma roupa ou uma cor, reescreva um título, mude a luz de uma cena ou junte pessoas e lugares de várias origens numa só imagem. Uma máscara PNG opcional limita a repintura a uma única área.
Escolha o modo pelo material de partida
| O que você tem | Modo |
|---|---|
| um briefing escrito | GPT Image 2 Texto para imagem |
| uma imagem para mudar | GPT Image 2 Edição de imagem |
Recursos e destaques
Edição por instrução, com máscara quando precisar
Sem máscara, o modelo deduz pelo prompt o que mudar e redesenha o resto de forma coerente. Com máscara, só os pixels transparentes são repintados e todo o resto fica.
Até dez origens por solicitação
Refira-se a cada origem pela ordem: a primeira imagem traz a pessoa, a segunda o cenário, a terceira o produto. O modelo junta tudo numa nova imagem.
Controle de fidelidade e formato
Input_fidelity high mantém rostos, tecidos e detalhes impressos mais próximos das origens. A proporção auto mantém o formato da primeira origem; qualquer uma das quinze proporções fixas dá esse formato ao resultado.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 5.000 caracteres. Coloque entre aspas duplas cada palavra que deve aparecer na imagem e diga onde ela fica; o resto é lido como descrição. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | De 1 a 10 imagens de origem. Refira-se a elas no prompt pela ordem (a primeira imagem, a segunda imagem). pelo menos 1 itens · no máximo 10 itens |
mask_url | Não | PNG opcional do mesmo tamanho da primeira imagem de origem. Pixels transparentes marcam a área a repintar; pixels opacos ficam como estão. |
aspect_ratio | Não | auto (padrão) mantém o formato da primeira imagem de origem em cerca de 1,5 megapixel e ignora o nível de tamanho; ou escolha uma das quinze proporções de 1:3 a 3:1. |
resolution | Não | 1k (padrão), 2k ou 4k. Uma imagem quadrada tem 1024, 2048 ou 2880 pixels de lado; um nível maior custa mais por imagem. |
quality | Não | low, medium (padrão) ou high. |
num_outputs | Não | De 1 a 10 imagens por solicitação, 1 por padrão. Cada imagem é cobrada separadamente. |
input_fidelity | Não | low (padrão) ou high. High mantém rostos, tecidos e detalhes impressos das origens mais fiéis. |
background | Não | auto (padrão) ou opaque. A OpenAI não oferece saída transparente no GPT Image 2; para recortes, use o GPT Image 2.5 Sunburst ou o Flare. |
output_format | Não | png (padrão), jpeg ou webp. Não altera o preço. |
output_quality | Não | Qualidade de compressão para jpeg e webp, de 0 a 100: valores mais altos preservam mais detalhe e geram arquivos maiores. Não é usada com png e não altera o preço. |
official_fallback | Não | Ligado por padrão. Valor padrão: |
Preços
Cobrado por imagem gerada conforme qualidade, nível de tamanho e proporção; na rota oficial, cada imagem de origem também acrescenta uma taxa fixa por imagem gerada. O orçamento mostra o total antes do envio. Uma solicitação de uma única edição PNG em qualidade medium e tamanho 1k, em qualquer proporção exceto 21:9, 9:21, 3:1 e 1:3, sem máscara, com input fidelity low e background auto começa na rota econômica, pelo preço econômico. Com o Official fallback ligado (padrão), uma solicitação que essa rota recusar ou não conseguir concluir é executada de novo na rota oficial, pelo preço oficial, por isso o orçamento mostra o preço inicial e o valor máximo. Solicitações recusadas não são cobradas. Na rota oficial, prompts longos acrescentam uma pequena taxa pelos tokens de entrada além dos primeiros 100, uma vez por solicitação; texto em chinês, japonês ou coreano conta cerca de um token por caractere.
| Especificação | Preço |
|---|---|
| $0.001816 / imagem |
| $0.001816 / imagem |
| $0.00244 / imagem |
| $0.00244 / imagem |
| $0.002752 / imagem |
| $0.002752 / imagem |
| $0.002872 / imagem |
| $0.002872 / imagem |
| $0.00304 / imagem |
| $0.00304 / imagem |
| $0.003568 / imagem |
| $0.003568 / imagem |
| $0.003736 / imagem |
| $0.003736 / imagem |
| $0.003856 / imagem |
| $0.003856 / imagem |
| $0.004192 / imagem |
| $0.004192 / imagem |
| $0.004456 / imagem |
| $0.004456 / imagem |
| $0.005104 / imagem |
| $0.005152 / imagem |
| $0.005152 / imagem |
| $0.005704 / imagem |
| $0.005704 / imagem |
| $0.005896 / imagem |
| $0.006016 / imagem |
| $0.006016 / imagem |
| $0.006712 / imagem |
| $0.006712 / imagem |
| $0.007312 / imagem |
| $0.007312 / imagem |
| $0.0076 / imagem |
| $0.0076 / imagem |
| $0.008128 / imagem |
| $0.008128 / imagem |
| $0.009304 / imagem |
| $0.009304 / imagem |
| $0.009928 / imagem |
| $0.009928 / imagem |
| $0.011176 / imagem |
| $0.011176 / imagem |
| $0.01192 / imagem |
| $0.01192 / imagem |
| $0.01324 / imagem |
| $0.01324 / imagem |
| $0.016216 / imagem |
| $0.016216 / imagem |
| $0.01396 / imagem |
| $0.01396 / imagem |
| $0.018592 / imagem |
| $0.018592 / imagem |
| $0.020368 / imagem (Com Official fallback: até $0.021472) |
| $0.020368 / imagem (Com Official fallback: até $0.021472) |
| $0.020998 / imagem (Com Official fallback: até $0.023992) |
| $0.020998 / imagem (Com Official fallback: até $0.023992) |
| $0.022 / imagem (Com Official fallback: até $0.028) |
| $0.022 / imagem (Com Official fallback: até $0.028) |
| $0.022864 / imagem (Com Official fallback: até $0.031456) |
| $0.022864 / imagem (Com Official fallback: até $0.031456) |
| $0.023626 / imagem (Com Official fallback: até $0.034504) |
| $0.023626 / imagem (Com Official fallback: até $0.034504) |
| $0.024112 / imagem |
| $0.024112 / imagem |
| $0.025636 / imagem (Com Official fallback: até $0.042544) |
| $0.027448 / imagem (Com Official fallback: até $0.049792) |
| $0.032272 / imagem |
| $0.032272 / imagem |
| $0.03688 / imagem |
| $0.03688 / imagem |
| $0.043072 / imagem |
| $0.043072 / imagem |
| $0.048064 / imagem |
| $0.048064 / imagem |
| $0.050776 / imagem |
| $0.050776 / imagem |
| $0.055432 / imagem |
| $0.055432 / imagem |
| $0.062416 / imagem |
| $0.062416 / imagem |
| $0.0652 / imagem |
| $0.0652 / imagem |
| $0.067984 / imagem |
| $0.067984 / imagem |
| $0.080464 / imagem |
| $0.080464 / imagem |
| $0.086032 / imagem |
| $0.086032 / imagem |
| $0.094288 / imagem |
| $0.094288 / imagem |
| $0.103984 / imagem |
| $0.103984 / imagem |
| $0.11296 / imagem |
| $0.11296 / imagem |
| $0.14272 / imagem |
| $0.14272 / imagem |
| $0.054616 / imagem |
| $0.054616 / imagem |
| $0.07144 / imagem |
| $0.07144 / imagem |
| $0.082936 / imagem |
| $0.082936 / imagem |
| $0.095248 / imagem |
| $0.095248 / imagem |
| $0.096472 / imagem |
| $0.096472 / imagem |
| $0.110728 / imagem |
| $0.110728 / imagem |
| $0.124624 / imagem |
| $0.124624 / imagem |
| $0.127864 / imagem |
| $0.127864 / imagem |
| $0.135064 / imagem |
| $0.135064 / imagem |
| $0.142816 / imagem |
| $0.142816 / imagem |
| $0.168976 / imagem |
| $0.171016 / imagem |
| $0.171016 / imagem |
| $0.19456 / imagem |
| $0.19456 / imagem |
| $0.197104 / imagem |
| $0.197104 / imagem |
| $0.197968 / imagem |
| $0.220456 / imagem |
| $0.220456 / imagem |
| $0.248464 / imagem |
| $0.248464 / imagem |
| $0.259552 / imagem |
| $0.259552 / imagem |
| $0.274216 / imagem |
| $0.274216 / imagem |
| $0.320608 / imagem |
| $0.320608 / imagem |
| $0.342928 / imagem |
| $0.342928 / imagem |
| $0.37588 / imagem |
| $0.37588 / imagem |
| $0.414736 / imagem |
| $0.414736 / imagem |
| $0.456544 / imagem |
| $0.456544 / imagem |
| $0.569656 / imagem |
| $0.569656 / imagem |
Casos de uso
Trocar texto e estilo de peças prontas
Troque as palavras de um pôster ou capa, a cor de um produto ou uma roupa, e deixe a foto por baixo exatamente como foi aprovada.
Montar cenas a partir de referências
Coloque uma pessoa de uma foto no cenário de outra, ou reúna duas pessoas fotografadas separadamente, sem reconstruir o layout a partir de um prompt de texto.
Versões locais de uma peça
Mantenha a foto e troque o título por uma linha traduzida para cada mercado, uma edição por idioma.
Guia de prompt e dicas práticas
Diga o que fica, além do que muda
Escreva primeiro a mudança e depois o que não pode se mexer: rosto, pose, luz, fundo, logo. Tudo o que você não proteger pode ser redesenhado.
Numere as origens
Escreva "a mulher da primeira imagem" e "o barco da segunda imagem". A ordem em image_urls é a única forma de o modelo distingui-las.
Use máscara para correções pequenas
Para um único objeto ou um pedaço do fundo, uma máscara PNG do tamanho da primeira origem é mais confiável que uma descrição em palavras.
Mantenha auto para preservar o enquadramento
Deixe a proporção em auto quando a edição deve manter o enquadramento da origem; escolha uma proporção fixa só quando o resultado precisar de um novo formato.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "openai/gpt-image-2/edit",
"input": {
"aspect_ratio": "auto",
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"input_fidelity": "low",
"num_outputs": 1,
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.





