API de imagens GPT Image 2

Use o GPT Image 2 por JSON síncrono ou SSE com heartbeat e receba um URL assinado temporário ou base64.

Gere PNGs com gpt-image-2 pela Images API compatível com OpenAI. A primeira versão gera uma imagem por pedido e suporta qualidade média ou alta, URL assinado de curta duração ou base64 e SSE opcional.

Escolher endpoint e modo

  • Use https://origin.modelflare.dev/v1 para JSON síncrono que possa demorar vários minutos.
  • Use https://modelflare.dev/v1 com stream=true para pedidos longos via Cloudflare; heartbeats SSE mantêm a ligação até a imagem final ficar pronta.
  • Não redirecione um POST em curso entre hosts.

Pedido síncrono

curl https://origin.modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"Uma cabana tranquila junto ao lago ao amanhecer","n":1,"quality":"medium","size":"1024x1024","response_format":"url","output_format":"png"}'

A resposta URL contém um link privado assinado do Modelflare que expira em uma hora. Use response_format=b64_json para receber o PNG validado sem persistir um objeto de saída.

A página ativa de Modelos e preços mostra preços medium e high para tamanhos comuns. A cobrança usa a qualidade e as dimensões exatas solicitadas, sem multiplicadores normais de grupos de roteamento, e registra o valor final nos logs de uso.

Pedido SSE

curl -N https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"Um gato branco corre por uma rua de néon sob a chuva","n":1,"quality":"high","size":"1024x1024","response_format":"url","stream":true}'

Os comentários SSE são apenas heartbeats. Termine após image_generation.completed e data: [DONE].

São aceites model, prompt, n=1, quality=medium|high, WIDTHxHEIGHT válido, response_format=url|b64_json, output_format=png e stream opcional. Edições, variações, imagens de referência, imagens parciais e campos desconhecidos são rejeitados. Credits reservados para pedidos falhados são devolvidos pelo caminho de reembolso idempotente por Request ID.

Use uma API Key normal. Keys fixadas a um canal são rejeitadas e uma Key com limites de modelo deve incluir gpt-image-2.