Introdução
GPT Image 2.5 Sunburst Edição de imagem aplica o gpt-image-2.5-sunburst da OpenAI às imagens que você já tem. Aceita de uma a dezesseis origens, uma máscara PNG opcional e a opção de fundo transparente, e é o modelo que a OpenAI recomenda quando a precisão de edição importa mais.
Escolha o modo pelo material de partida
| O que você tem | Modo |
|---|---|
| um briefing escrito | GPT Image 2.5 Sunburst Texto para imagem |
| uma imagem para mudar | GPT Image 2.5 Sunburst Edição de imagem |
Recursos e destaques
Máscaras, fidelidade e transparência
Uma máscara limita a repintura aos seus pixels transparentes; input_fidelity high mantém rostos e tecidos mais próximos das origens; background transparent devolve um canal alfa de verdade em PNG ou WebP.
Até dezesseis origens
Junte pessoas, cenários e produtos de até dezesseis imagens numa solicitação, cada uma citada pela ordem no prompt. Cada origem acrescenta uma taxa fixa de entrada a cada imagem gerada, então inclua só as referências que importam.
Precisão é o objetivo
Na nossa edição do vestido carmesim, só o tecido mudou: mangas de renda, rosto, cadeira e a única luz principal ficaram onde estavam.
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 16 imagens de origem. Refira-se a elas no prompt pela ordem (a primeira imagem, a segunda imagem). pelo menos 1 itens · no máximo 16 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 | Quinze proporções de 1:3 a 3:1, 1:1 por padrão. O resultado segue a proporção que você escolher, não a da origem, e a proporção muda o preço. |
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, high (padrão), xhigh ou max. Cada nível acrescenta detalhe, tempo e custo; deixe xhigh e max para as versões finais. |
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), transparent ou opaque. Transparent exige saída png ou webp e devolve um canal alfa de verdade. |
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 high e tamanho 1k, na proporção 1:1, 3:2, 2:3, 4:3, 3:4, 16:9 ou 9:16, 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.00304 / imagem |
| $0.00304 / imagem |
| $0.003568 / imagem |
| $0.003568 / imagem |
| $0.003808 / imagem |
| $0.003808 / imagem |
| $0.003856 / imagem |
| $0.003856 / imagem |
| $0.004192 / imagem |
| $0.004192 / imagem |
| $0.004744 / imagem |
| $0.004744 / imagem |
| $0.005104 / imagem |
| $0.00568 / imagem |
| $0.00568 / imagem |
| $0.00652 / imagem |
| $0.00652 / imagem |
| $0.007312 / imagem |
| $0.007312 / imagem |
| $0.008176 / imagem |
| $0.008176 / imagem |
| $0.008728 / imagem |
| $0.008728 / imagem |
| $0.010936 / imagem |
| $0.01396 / imagem |
| $0.01396 / imagem |
| $0.018592 / imagem |
| $0.018592 / imagem |
| $0.020998 / imagem (Com Official fallback: até $0.023992) |
| $0.020998 / imagem (Com Official fallback: até $0.023992) |
| $0.021472 / imagem |
| $0.021472 / imagem |
| $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.024136 / imagem |
| $0.024136 / imagem |
| $0.025636 / imagem (Com Official fallback: até $0.042544) |
| $0.0316 / imagem |
| $0.0316 / imagem |
| $0.034504 / imagem |
| $0.034504 / imagem |
| $0.037864 / imagem |
| $0.037864 / imagem |
| $0.043504 / imagem |
| $0.043504 / imagem |
| $0.049816 / imagem |
| $0.049816 / imagem |
| $0.054616 / imagem |
| $0.054616 / imagem |
| $0.055624 / imagem |
| $0.055624 / imagem |
| $0.059872 / imagem |
| $0.059872 / imagem |
| $0.07144 / imagem |
| $0.07144 / imagem |
| $0.075328 / imagem |
| $0.082936 / imagem |
| $0.082936 / imagem |
| $0.096472 / imagem |
| $0.096472 / imagem |
| $0.110728 / imagem |
| $0.110728 / imagem |
| $0.124624 / imagem |
| $0.124624 / imagem |
| $0.135064 / imagem |
| $0.135064 / imagem |
| $0.168976 / imagem |
| $0.002872 / imagem |
| $0.002872 / imagem |
| $0.004456 / imagem |
| $0.004456 / imagem |
| $0.005152 / imagem |
| $0.005152 / imagem |
| $0.005704 / imagem |
| $0.005704 / imagem |
| $0.006328 / imagem |
| $0.006328 / imagem |
| $0.006712 / imagem |
| $0.006712 / imagem |
| $0.007312 / imagem |
| $0.007312 / imagem |
| $0.008128 / imagem |
| $0.008128 / imagem |
| $0.009088 / imagem |
| $0.009088 / imagem |
| $0.009928 / imagem |
| $0.01108 / imagem |
| $0.01108 / imagem |
| $0.01276 / imagem |
| $0.01276 / imagem |
| $0.014176 / imagem |
| $0.014176 / imagem |
| $0.015904 / imagem |
| $0.015904 / imagem |
| $0.017296 / imagem |
| $0.017296 / imagem |
| $0.021808 / imagem |
| $0.024112 / imagem |
| $0.024112 / imagem |
| $0.03688 / imagem |
| $0.03688 / imagem |
| $0.041896 / imagem |
| $0.041896 / imagem |
| $0.043072 / imagem |
| $0.043072 / imagem |
| $0.048064 / imagem |
| $0.048064 / imagem |
| $0.055432 / imagem |
| $0.055432 / imagem |
| $0.062416 / imagem |
| $0.062416 / imagem |
| $0.062944 / imagem |
| $0.062944 / imagem |
| $0.067984 / imagem |
| $0.067984 / imagem |
| $0.07624 / imagem |
| $0.07624 / imagem |
| $0.086032 / imagem |
| $0.087496 / imagem |
| $0.087496 / imagem |
| $0.095248 / imagem |
| $0.095248 / imagem |
| $0.098968 / imagem |
| $0.098968 / imagem |
| $0.110656 / imagem |
| $0.110656 / imagem |
| $0.121312 / imagem |
| $0.121312 / imagem |
| $0.142816 / imagem |
| $0.142816 / imagem |
| $0.152632 / imagem |
| $0.171016 / imagem |
| $0.171016 / imagem |
| $0.19456 / imagem |
| $0.19456 / imagem |
| $0.220456 / imagem |
| $0.220456 / imagem |
| $0.248464 / imagem |
| $0.248464 / imagem |
| $0.274216 / imagem |
| $0.274216 / imagem |
| $0.342928 / imagem |
| $0.003736 / imagem |
| $0.003736 / imagem |
| $0.006016 / imagem |
| $0.006016 / imagem |
| $0.0076 / imagem |
| $0.0076 / imagem |
| $0.008368 / imagem |
| $0.008368 / imagem |
| $0.009304 / imagem |
| $0.009304 / imagem |
| $0.011176 / imagem |
| $0.011176 / imagem |
| $0.01192 / imagem |
| $0.01192 / imagem |
| $0.0124 / imagem |
| $0.0124 / imagem |
| $0.01324 / imagem |
| $0.01324 / imagem |
| $0.016216 / imagem |
| $0.0166 / imagem |
| $0.0166 / imagem |
| $0.02116 / imagem |
| $0.02116 / imagem |
| $0.023872 / imagem |
| $0.023872 / imagem |
| $0.026296 / imagem |
| $0.026296 / imagem |
| $0.028552 / imagem |
| $0.028552 / imagem |
| $0.032272 / imagem |
| $0.032272 / imagem |
| $0.035992 / imagem |
| $0.050776 / imagem |
| $0.050776 / imagem |
| $0.056176 / imagem |
| $0.056176 / imagem |
| $0.0652 / imagem |
| $0.0652 / imagem |
| $0.080464 / imagem |
| $0.080464 / imagem |
| $0.086752 / imagem |
| $0.086752 / imagem |
| $0.094288 / imagem |
| $0.094288 / imagem |
| $0.103984 / imagem |
| $0.103984 / imagem |
| $0.11296 / imagem |
| $0.11296 / imagem |
| $0.115576 / imagem |
| $0.115576 / imagem |
| $0.127864 / imagem |
| $0.127864 / imagem |
| $0.14272 / imagem |
| $0.14272 / imagem |
| $0.14272 / imagem |
| $0.168592 / imagem |
| $0.168592 / imagem |
| $0.184552 / imagem |
| $0.184552 / imagem |
| $0.197104 / imagem |
| $0.197104 / imagem |
| $0.201832 / imagem |
| $0.201832 / imagem |
| $0.253408 / imagem |
| $0.259552 / imagem |
| $0.259552 / imagem |
| $0.320608 / imagem |
| $0.320608 / imagem |
| $0.37588 / imagem |
| $0.37588 / imagem |
| $0.414736 / imagem |
| $0.414736 / imagem |
| $0.456544 / imagem |
| $0.456544 / imagem |
| $0.569656 / imagem |
Casos de uso
Retocar fotos aprovadas
Mude uma roupa, uma cor ou a luz numa foto aprovada sem tocar no resto da imagem, com ou sem máscara.
Recortes para layouts
Pessoas e produtos devolvidos em fundo transparente, prontos para um layout, um slide ou uma página de produto sem uma etapa separada de remoção de fundo.
Variações de cor de produto
Uma única foto de produto em vários acabamentos ou cores, com máscara no produto para que cenário e luz fiquem idênticos.
Guia de prompt e dicas práticas
Monte a máscara a partir da origem
Mesmo tamanho em pixels da primeira origem, salva em PNG, transparente só onde a repintura deve acontecer. Tudo o que for opaco fica protegido.
Escreva a lista de proteção por extenso
Depois da mudança, diga o que precisa ficar: rosto, cabelo, pose, cadeira, luz. O modelo segue uma lista escrita com mais confiabilidade que uma implícita.
Nos recortes, diga o que fica
Diga qual assunto fica e que o fundo deve ser totalmente transparente, e defina output_format como png ou webp.
Confira o canal alfa antes do layout
Abra o PNG ou WebP devolvido na sua ferramenta de layout: a área vazia é um canal alfa de verdade, então não é preciso nenhuma etapa extra de chroma key ou máscara.
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.5-sunburst/edit",
"input": {
"aspect_ratio": "1:1",
"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.





