API Images GPT Image 2

Appelez GPT Image 2 par JSON synchrone ou SSE avec heartbeat et recevez une URL signée temporaire ou du base64.

Générez des PNG avec gpt-image-2 via l’API Images compatible OpenAI. La première version produit une image par requête et accepte la qualité moyenne ou haute, une URL signée temporaire ou base64, et SSE en option.

Choisir le point d’accès et le mode

  • Utilisez https://origin.modelflare.dev/v1 pour le JSON synchrone pouvant durer plusieurs minutes.
  • Utilisez https://modelflare.dev/v1 avec stream=true pour les longues requêtes via Cloudflare ; des heartbeats SSE maintiennent la connexion jusqu’à l’image finale.
  • Ne redirigez pas un POST en cours entre les hôtes.

Requête synchrone

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":"Une cabane paisible au bord d’un lac à l’aube","n":1,"quality":"medium","size":"1024x1024","response_format":"url","output_format":"png"}'

La réponse URL contient un lien privé signé Modelflare valable une heure. Utilisez response_format=b64_json pour recevoir directement le PNG validé sans conserver d’objet de sortie API.

La page Modèles et tarifs en direct affiche les tarifs medium et high pour les tailles courantes. La facturation utilise la qualité et les dimensions exactes demandées, sans multiplicateur de groupe de routage standard, et inscrit le montant final dans les journaux d’utilisation.

Requête 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":"Un chat blanc court dans une rue au néon sous la pluie","n":1,"quality":"high","size":"1024x1024","response_format":"url","stream":true}'

Les commentaires SSE sont uniquement des heartbeats. Arrêtez après image_generation.completed et data: [DONE].

Sont pris en charge : model, prompt, n=1, quality=medium|high, un WIDTHxHEIGHT valide, response_format=url|b64_json, output_format=png et stream facultatif. Les éditions, variations, images de référence ou partielles et champs inconnus sont refusés. Les Credits réservés pour une requête échouée sont restitués par le remboursement idempotent lié au Request ID.

Utilisez une clé API normale. Les clés épinglées à un canal sont refusées et une clé limitée par modèle doit inclure gpt-image-2.