CheaperGen

Documentazione API di GPT Image 2.5 Flare

Tutto ciò che ti serve per chiamare GPT Image 2.5 Flare dal tuo codice. URL di base: https://cheapergen.com/api/v1. Provalo prima nel playground.

Usi un agente di programmazione?

Incolla questo testo in Claude Code, Cursor, Codex o qualsiasi agente di programmazione. Aggiunge l’API al tuo progetto, conserva la chiave in CHEAPERGEN_API_KEY ed esegue una prova con un preventivo gratuito prima di spendere.

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
Cosa legge il tuo agente

Autenticazione

Crea una chiave in Dashboard → Chiavi API, inviala come token bearer e conservala lato server.

export CHEAPERGEN_API_KEY="cg_live_…"

# every request
Authorization: Bearer $CHEAPERGEN_API_KEY

API GPT Image 2.5 Flare Da testo a immagine

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

Invia un job asincrono e restituisce 202 con l’ID della generazione. Interroga GET /api/v1/generations/{id} o specifica webhook_url. Consulta il ciclo di vita dei job.

Parametri di input

NomeTipoDescrizioneEffetto sul prezzo
promptobbligatoriostringDescrivi l’inquadratura: soggetto, azione, movimento della camera, illuminazione e stile.Sì
aspect_ratiostring (enum)Formato dell'immagine di output.
Valori: 1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 5:4 · 4:5 · 16:9 · 9:16 · 21:9 · 9:21
Predefinito: 1:1
Sì
resolutionstring (enum)Livello di risoluzione dell’output: 1K (≈1 MP), 2K (≈4 MP) o 4K (≈8 MP, sperimentale).
Valori: 1K · 2K · 4K
Predefinito: 1K
Sì
qualitystring (enum)Impegno di rendering. Una qualità più alta usa più token di output e costa di più; xhigh e max sono pensati per i contenuti definitivi.
Valori: low · medium · high · xhigh · max
Predefinito: medium
Sì
webhook_urlstringa (URL)Facoltativo. Inviamo con POST la generazione completata a questo indirizzo, firmandola con il segreto del webhook. WebhookNo

Richiesta

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": "Poster minimalista per una serata jazz intitolata “BLUE HOUR”, sagoma di un sassofono, blu profondo e ottone, tipografia essenziale",
    "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);

Risposta

{
  "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": "Poster minimalista per una serata jazz intitolata “BLUE HOUR”, sagoma di un sassofono, blu profondo e ottone, tipografia essenziale",
    "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"
}

API GPT Image 2.5 Flare Modifica immagine

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

Invia un job asincrono e restituisce 202 con l’ID della generazione. Interroga GET /api/v1/generations/{id} o specifica webhook_url. Consulta il ciclo di vita dei job.

Parametri di input

NomeTipoDescrizioneEffetto sul prezzo
promptobbligatoriostringDescrivi l’inquadratura: soggetto, azione, movimento della camera, illuminazione e stile.Sì
image_urlsobbligatoriostring[] (URLs)Fino a 16 immagini da modificare o combinare. Nel prompt, richiamale come “image 1”, “image 2”…
Numero massimo di elementi: 16
No
aspect_ratiostring (enum)Formato dell'immagine di output.
Valori: 1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 5:4 · 4:5 · 16:9 · 9:16 · 21:9 · 9:21
Predefinito: 1:1
Sì
resolutionstring (enum)Livello di risoluzione dell’output: 1K (≈1 MP), 2K (≈4 MP) o 4K (≈8 MP, sperimentale).
Valori: 1K · 2K · 4K
Predefinito: 1K
Sì
qualitystring (enum)Impegno di rendering. Una qualità più alta usa più token di output e costa di più; xhigh e max sono pensati per i contenuti definitivi.
Valori: low · medium · high · xhigh · max
Predefinito: medium
Sì
webhook_urlstringa (URL)Facoltativo. Inviamo con POST la generazione completata a questo indirizzo, firmandola con il segreto del webhook. WebhookNo

Richiesta

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": "Mantieni invariati il prodotto e la sua etichetta; sostituisci lo sfondo con un fondale da studio bianco caldo e uniforme e aggiungi un’ombra naturale",
    "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);

Risposta

{
  "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": "Mantieni invariati il prodotto e la sua etichetta; sostituisci lo sfondo con un fondale da studio bianco caldo e uniforme e aggiungi un’ombra naturale",
    "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"
}

Ottieni il risultato

Le generazioni sono asincrone. Continua a interrogare finché il campo status non vale succeeded, failed o canceled; oppure specifica webhook_url al momento dell’invio. Le generazioni non riuscite vengono rimborsate automaticamente.

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

Altro: ciclo di vita dei job · i webhook · errori

prezzi di GPT Image 2.5 Flare

Paga per immagine man mano che le usi, senza abbonamento (piani mensili sono facoltativi). Le generazioni non riuscite vengono rimborsate automaticamente.

FasciaPrezzo ufficialeCheaperGen
1K · Bassa
1024×1024
$0,0064/img$0,0061/img
2K · Bassa
2048×2048
$0,0124/img$0,0114/img
1K · Media
1024×1024
$0,0137/img$0,0126/img
2K · Media
2048×2048
$0,0273/img$0,0254/img
1K · high
1024×1024
$0,0532/img$0,0492/img
2K · high
2048×2048
$0,1075/img$0,0999/img
  • Prezzo ufficiale: Prezzo di listino OpenAI API per gpt-image-2.5-flare ($30 / 1M di token immagine in uscita, $5 / 1M di token di testo in input, $8 / 1M di token immagine in input; token di output per immagine calcolati con il calcolatore dei costi di GPT Image 2.5 di OpenAI, più un prompt tipico). Prezzi verificati il 18 ottobre 2026.
  • I prezzi per immagine si riferiscono a immagini quadrate e includono un prompt tipico; ogni immagine di input aggiunge circa $0.016.
  • La qualità xhigh e max costa di più: controlla il prezzo nell’area di prova.