Introdução
GPT Image 2.5 Flare Edição de imagem aplica o gpt-image-2.5-flare da OpenAI às imagens que você já tem. Aceita de uma a dezesseis origens, uma máscara PNG e a opção de fundo transparente, e devolve as edições rápido o bastante para uso interativo.
Escolha o modo pelo material de partida
| O que você tem | Modo |
|---|---|
| um briefing escrito | GPT Image 2.5 Flare Texto para imagem |
| uma imagem para mudar | GPT Image 2.5 Flare Edição de imagem |
Recursos e destaques
Composições rápidas de várias origens
Duas ou mais origens viram uma cena, com os rostos mantidos das próprias imagens. Nosso exemplo com duas origens terminou bem antes de um minuto.
Máscaras e recortes
Uma máscara PNG limita a repintura a uma área; background transparent devolve um canal alfa de verdade em PNG ou WebP, pronto para um layout sem chroma key.
Várias mudanças de uma vez
Roupa, hora do dia e clima podem mudar juntos, desde que o prompt diga também o que fica igual. Nosso exemplo do terraço mudou vestido e luz numa só solicitação.
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
Provas de roupa e reestilização
Mostre a mesma pessoa com uma roupa nova ou num lugar novo para um lookbook ou um rascunho de campanha, com várias opções por solicitação.
Juntar pessoas de fotos separadas
Coloque na mesma imagem duas pessoas fotografadas separadamente, para um pôster, uma miniatura ou um painel de story.
Atualizações sazonais
Transforme uma imagem de campanha de verão numa versão de outono ou noturna para a próxima estação, com pessoa e produto inalterados.
Guia de prompt e dicas práticas
Dê uma função a cada origem
O homem e a porta vêm da primeira imagem, a mulher da segunda: escreva isso, porque a ordem é o único elo entre o prompt e as origens.
Agrupe mudanças relacionadas
Uma roupa nova e outra hora do dia se expressam bem numa solicitação; mudanças sem relação funcionam melhor como edições separadas.
Aumente a fidelidade para rostos
Defina input_fidelity como high quando um rosto precisar continuar reconhecível depois da edição; o preço não muda.
Use máscara para trocar o fundo
Quando só o fundo deve mudar, deixe o assunto opaco e o fundo transparente numa máscara PNG do tamanho da primeira origem.
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-flare/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.





