gpt-image-2.5-flare API

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

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

Parâmetros: size=1536x1024quality=mediumn=1

Prompt: Children's picture-book illustration: a small fox carrying a paper lantern through a snowy birch forest at dusk, soft gouache textures, gentle blues and warm orange glow, friendly and calm, no text.

Solicitação que produziu esta amostra

{
  "model": "gpt-image-2.5-flare",
  "prompt": "Children's picture-book illustration: a small fox carrying a paper lantern through a snowy birch forest at dusk, soft gouache textures, gentle blues and warm orange glow, friendly and calm, no text.",
  "n": 1,
  "size": "1536x1024",
  "quality": "medium"
}

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-flare",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "high", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

Solicitar notas

GPT Image 2.5 Flare é o padrão rápido e de alta qualidade para geração e edição diária; preserve images[], image[], mask e os controles de saída completos.

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-flare
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-flare",
    "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": "high", "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-flare" \
  -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=high" \
  -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.