gpt-image-2.5-sunburst API

Use o ID exato do modelo gpt-image-2.5-sunburst. O campo do modelo deve corresponder exatamente a esta página.

Exemplo de saídagpt-image-2.5-sunburstPOST /v1/images/generations

Parâmetros: size=1536x1024n=1

Prompt: The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.

Solicitação que produziu esta amostra

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.",
  "n": 1,
  "size": "1536x1024"
}

Autenticação e endpoint

Use uma chave de API Modelflare com https://modelflare.dev/v1. O ponto de entrada do gateway é POST /v1/images/generations.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Gerar uma imagem

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

Solicitar notas

GPT Image 2.5 Sunburst visa criação e edição com maior fidelidade e maior controle; preserve images[], image[], mask, xhigh/max e controles de saída para ambas as operações.

Parâmetros de solicitação

GPT Image 2.5 usa a API de imagens compatível com OpenAI. A geração usa JSON; a edição aceita referências de imagem JSON ou arquivos multipartes; as respostas retornam dados de imagem Base64 em data[].b64_json.

Campo	Obrigatório	Notas
model	Sim	gpt-image-2.5-sunburst
prompt	Sim	Instrução de geração ou edição, 1–32.000 caracteres
images[]	Condicional	Para edições JSON, até 16 objetos file_id ou image_url
images[].file_id	Condicional	ID da API do arquivo enviado
images[].image_url	Condicional	URL de imagem ou URL de dados Base64; URLs de dados são limitados a 20.971.520 caracteres
image	Condicional	Um arquivo fonte multipart; use image[] para vários arquivos
image[]	Condicional	Para edições multipartes, até 16 arquivos de origem
mask	Não	Máscara alfa correspondente ao primeiro formato/tamanho de origem e menor que 50 MB
size	Não	auto ou personalizado WIDTHxHEIGHT; Múltiplos de 16 pixels, proporção de 1:3–3:1, borda máxima de 3.840px e total de 655.360–8.294.400 pixels
quality	Não	low / medium / high / xhigh / max / auto; padrão auto
background	Não	auto/opaque/transparent; fundos transparentes requerem saída PNG ou WebP
output_format	Não	png/jpeg/webp; padrão png
output_compression	Não	0–100 para JPEG/WebP, padrão 100; ignorado para PNG
moderation	Não	auto / low; padrão auto
n	Não	1–10 saídas; padrão 1

Limites de resposta e entrada

GPT Image 2.5 Flare e Sunburst suportam até 16 entradas de edição. As edições JSON usam images[] com file_id ou image_url; edições multipartes usam image/image[], com cada imagem de origem e máscara com menos de 50 MB. Os prompts têm de 1 a 32.000 caracteres; suporte de qualidade low/medium/high/xhigh/max/auto; as regras de tamanho são múltiplos de 16 pixels, proporção de 1:3–3:1, borda máxima de 3.840px e 655.360–8.294.400 pixels no total. Fundos transparentes requerem PNG ou WebP; a compactação se aplica apenas a JPEG/WebP e é ignorada para PNG. As resoluções acima de 2560x1440 são experimentais. Leia data[].b64_json; não envie somente DALL·E response_format. Flare é o padrão rápido e de alta qualidade para geração e edição diária; Sunburst é para trabalhos de maior fidelidade e maior controle.

Editar imagens

GPT Image 2.5 oferece suporte a referências de imagem JSON e uploads de arquivos multipartes por meio de /v1/images/edits. JSON aceita até 16 objetos usando file_id ou image_url; multipart aceita até 16 arquivos de origem. Não misture images com image/image[] em uma solicitação.

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "images": [{"file_id": "file-example123"}, {"image_url": "https://example.com/reference.png"}],
    "prompt": "Keep the product unchanged and replace the background with a warm studio gradient",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "png", "n": 1
  }'

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=Keep the product unchanged and replace the background with a warm studio gradient" \
  -F "size=1536x1024" \
  -F "quality=xhigh" \
  -F "background=opaque" \
  -F "output_format=png" \
  -F "n=1"

Forma de resposta

Leitura dos resultados gerados e editados em data[]. GPT Image 2.5 retorna dados de imagem Base64; não trate a resposta como saída de URL.

Campo	Notas
created	Tempo de criação como carimbo de data/hora Unix em segundos
data	Resultados de imagens geradas ou editadas
data[].b64_json	Dados de imagem codificados em Base64
background	Modo de fundo final: opaque ou transparent
output_format	Formato de imagem retornado: png, jpeg ou webp
quality	Nível de qualidade usado
size	Dimensões finais como WIDTHxHEIGHT

Erros e tarefas com falha

Parâmetros de modelo inválidos retornam um 4xx com um ID de solicitação; use os campos de resposta e a mensagem de erro definidos pelo contrato modelo selecionado.

Escopo suportado

Esta página cobre chamadas de geração e edição de modelo Modelflare. O enriquecimento de pesquisa ou mapa, gerenciamento de voz e gerenciamento de biblioteca de elementos são APIs de recursos fora dessa superfície pública de chamada de modelo e não são campos de solicitação obrigatórios.

Preços e cobrança

Este modelo utiliza faturamento baseado em token. Consulte a página de preços do modelo para obter o preço atual do cliente, a lista de preços de referência e as especificações completas.

Nota

Esta página documenta a interface pública do Modelflare; os campos e limites mostrados aqui são o contrato atual.