Documentation de l’API GPT Image 2.5 Flare

Name: API GPT Image 2.5 Flare
Brand: OpenAI
SKU: openai/gpt-image-2.5-flare
Availability: InStock

Tout ce dont vous avez besoin pour appeler GPT Image 2.5 Flare depuis votre code. URL de base : https://cheapergen.com/api/v1. Essayez d’abord dans l’interface playground.

Vous utilisez un agent de programmation ?

Collez ceci dans Claude Code, Cursor, Codex ou tout autre agent de programmation. Il ajoute l’API à votre projet, conserve la clé dans CHEAPERGEN_API_KEY et teste le devis gratuit avant toute dépense.

Add GPT Image 2.5 Flare (CheaperGen endpoint openai/gpt-image-2.5-flare/text-to-image) to this project by following https://cheapergen.com/agents/integrate.md

Ce que votre agent lit

Authentification

Créez une clé dans Tableau de bord → Clés API et envoyez-la comme jeton Bearer. Conservez les clés côté serveur.

export CHEAPERGEN_API_KEY="cg_live_…"

# every request
Authorization: Bearer $CHEAPERGEN_API_KEY

API GPT Image 2.5 Flare Texte en image

POST/api/v1/run/openai/gpt-image-2.5-flare/text-to-image

Envoie une tâche asynchrone et renvoie 202 avec un ID de génération. Interrogez GET /api/v1/generations/{id} ou indiquez webhook_url. Voir cycle de vie des tâches.

Paramètres d’entrée

Nom	Type	Description	Influe sur le prix
`prompt`requis	string	Décrivez le plan : sujet, action, mouvement de caméra, éclairage et style.	Oui
`aspect_ratio`	string (enum)	Format de l’image de sortie. Valeurs : 1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 5:4 · 4:5 · 16:9 · 9:16 · 21:9 · 9:21 Par défaut : 1:1	Oui
`resolution`	string (enum)	Palier de taille de sortie : 1K (≈1 MP), 2K (≈4 MP) ou 4K (≈8 MP, expérimental). Valeurs : 1K · 2K · 4K Par défaut : 1K	Oui
`quality`	string (enum)	Niveau d’effort de rendu. Une qualité supérieure utilise davantage de jetons de sortie et coûte plus cher ; xhigh et max conviennent aux ressources finales. Valeurs : low · medium · high · xhigh · max Par défaut : medium	Oui
`webhook_url`	chaîne (URL)	Facultatif. Nous envoyons la génération terminée par POST à cette adresse, avec une signature calculée à l’aide de votre secret de webhook. Webhooks	Non

Requête

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/openai/gpt-image-2.5-flare/text-to-image`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Affiche pour une soirée jazz intitulée « BLUE HOUR », silhouette de saxophone, tons bleu profond et laiton, typographie épurée",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "quality": "medium"
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.images[0].url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/openai/gpt-image-2.5-flare/text-to-image", headers=headers, json={
    "prompt": "Affiche pour une soirée jazz intitulée « BLUE HOUR », silhouette de saxophone, tons bleu profond et laiton, typographie épurée",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "quality": "medium"
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["images"][0]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/openai/gpt-image-2.5-flare/text-to-image \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Affiche pour une soirée jazz intitulée « BLUE HOUR », silhouette de saxophone, tons bleu profond et laiton, typographie épurée",
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "quality": "medium"
}'

Réponse

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "openai/gpt-image-2.5-flare",
  "endpoint": "openai/gpt-image-2.5-flare/text-to-image",
  "mode": "text-to-image",
  "status": "queued",
  "input": {
    "prompt": "Affiche pour une soirée jazz intitulée « BLUE HOUR », silhouette de saxophone, tons bleu profond et laiton, typographie épurée",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "quality": "medium"
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "openai/gpt-image-2.5-flare",
  "endpoint": "openai/gpt-image-2.5-flare/text-to-image",
  "mode": "text-to-image",
  "status": "succeeded",
  "input": {
    "prompt": "Affiche pour une soirée jazz intitulée « BLUE HOUR », silhouette de saxophone, tons bleu profond et laiton, typographie épurée",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "quality": "medium"
  },
  "output": {
    "images": [
      {
        "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q-0.png",
        "content_type": "image/png",
        "width": 2048,
        "height": 2048
      }
    ]
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

API GPT Image 2.5 Flare Retouche d’image

POST/api/v1/run/openai/gpt-image-2.5-flare/edit

Envoie une tâche asynchrone et renvoie 202 avec un ID de génération. Interrogez GET /api/v1/generations/{id} ou indiquez webhook_url. Voir cycle de vie des tâches.

Paramètres d’entrée

Nom	Type	Description	Influe sur le prix
`prompt`requis	string	Décrivez le plan : sujet, action, mouvement de caméra, éclairage et style.	Oui
`image_urls`requis	string[] (URLs)	Jusqu’à 16 images à retoucher ou à combiner. Mentionnez-les dans le prompt sous la forme « image 1 », « image 2 »… Nombre maximal d’éléments : 16	Non
`aspect_ratio`	string (enum)	Format de l’image de sortie. Valeurs : 1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 5:4 · 4:5 · 16:9 · 9:16 · 21:9 · 9:21 Par défaut : 1:1	Oui
`resolution`	string (enum)	Palier de taille de sortie : 1K (≈1 MP), 2K (≈4 MP) ou 4K (≈8 MP, expérimental). Valeurs : 1K · 2K · 4K Par défaut : 1K	Oui
`quality`	string (enum)	Niveau d’effort de rendu. Une qualité supérieure utilise davantage de jetons de sortie et coûte plus cher ; xhigh et max conviennent aux ressources finales. Valeurs : low · medium · high · xhigh · max Par défaut : medium	Oui
`webhook_url`	chaîne (URL)	Facultatif. Nous envoyons la génération terminée par POST à cette adresse, avec une signature calculée à l’aide de votre secret de webhook. Webhooks	Non

Requête

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/openai/gpt-image-2.5-flare/edit`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Conservez exactement le produit et son étiquette ; remplacez l’arrière-plan par un fond de studio blanc cassé et ajoutez une ombre naturelle.",
    "image_urls": [
      "https://cdn.cheapergen.com/samples/portrait.jpg"
    ],
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "quality": "medium"
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.images[0].url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/openai/gpt-image-2.5-flare/edit", headers=headers, json={
    "prompt": "Conservez exactement le produit et son étiquette ; remplacez l’arrière-plan par un fond de studio blanc cassé et ajoutez une ombre naturelle.",
    "image_urls": [
        "https://cdn.cheapergen.com/samples/portrait.jpg"
    ],
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "quality": "medium"
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["images"][0]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/openai/gpt-image-2.5-flare/edit \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Conservez exactement le produit et son étiquette ; remplacez l’arrière-plan par un fond de studio blanc cassé et ajoutez une ombre naturelle.",
  "image_urls": [
    "https://cdn.cheapergen.com/samples/portrait.jpg"
  ],
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "quality": "medium"
}'

Réponse

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "openai/gpt-image-2.5-flare",
  "endpoint": "openai/gpt-image-2.5-flare/edit",
  "mode": "edit",
  "status": "queued",
  "input": {
    "prompt": "Conservez exactement le produit et son étiquette ; remplacez l’arrière-plan par un fond de studio blanc cassé et ajoutez une ombre naturelle.",
    "image_urls": [
      "https://cdn.cheapergen.com/samples/portrait.jpg"
    ],
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "quality": "medium"
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "openai/gpt-image-2.5-flare",
  "endpoint": "openai/gpt-image-2.5-flare/edit",
  "mode": "edit",
  "status": "succeeded",
  "input": {
    "prompt": "Conservez exactement le produit et son étiquette ; remplacez l’arrière-plan par un fond de studio blanc cassé et ajoutez une ombre naturelle.",
    "image_urls": [
      "https://cdn.cheapergen.com/samples/portrait.jpg"
    ],
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "quality": "medium"
  },
  "output": {
    "images": [
      {
        "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q-0.png",
        "content_type": "image/png",
        "width": 2048,
        "height": 2048
      }
    ]
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

Récupérer le résultat

Les générations sont asynchrones. Interrogez leur état jusqu’à ce que status soit succeeded, failed ou canceled, ou indiquez webhook_url lors de l’envoi. Les générations échouées sont automatiquement remboursées.

curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY"

Pour en savoir plus : cycle de vie des tâches · webhooks · erreurs

Tarifs de GPT Image 2.5 Flare

Payez par image à l’usage, sans abonnement requis (forfaits mensuels facultatifs). Les générations échouées sont remboursées automatiquement.

Offre	Prix officiel	CheaperGen	Vous économisez
1K · Low 1024×1024	~~$0,0064~~/img	$0,0061/img	−5%
2K · Low 2048×2048	~~$0,0124~~/img	$0,0114/img	−8%
1K · Medium 1024×1024	~~$0,0137~~/img	$0,0126/img	−8%
2K · Medium 2048×2048	~~$0,0273~~/img	$0,0254/img	−7%
1K · high 1024×1024	~~$0,0532~~/img	$0,0492/img	−8%
2K · high 2048×2048	~~$0,1075~~/img	$0,0999/img	−7%

Prix officiel : Prix catalogue de l’API OpenAI pour gpt-image-2.5-flare ($30 / 1M jetons image de sortie, $5 / 1M jetons texte d’entrée, $8 / 1M jetons image d’entrée ; jetons image de sortie par image calculés avec l’outil de tarification GPT Image 2.5 d’OpenAI, avec un prompt type). Tarifs vérifiés le 18 octobre 2026.
Les tarifs par image sont calculés pour des images carrées et incluent un prompt type ; chaque image d’entrée ajoute environ $0.016.
Les niveaux de qualité xhigh et max coûtent plus cher — consultez le prix dans l’aire de test.