GPT Images 2.5 Flare · Text to Image

Generate images from text with GPT Images 2.5 Flare. Use the default SeeAPI provider for single-image 1K–4K output, or select fal for provider-specific quality, format, background, and native multi-image controls.

Developer API pricing

Provider: SeeAPI

USD estimate: $0.0037 / credit · Estimated equivalent, not an additional charge.

1K: 10 credits/gen (≈ $0.037/gen)

2K: 15 credits/gen (≈ $0.056/gen)

4K: 22 credits/gen (≈ $0.082/gen)

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task DetailsLearn how to query task status and retrieve generation results

For production workloads, provide callback_url and verify webhook signatures. Use the task-status endpoint when a callback is delayed.

Related Resources

Market Overview

Explore all available models

Credits & Billing

View credit balance, plans, and billing activity

Usage

Review API usage and credit consumption

Callbacks

Manage the secret used to verify generation webhook signatures. Callback URLs are supplied when you create each generation.

Webhook flow

Callback URL per generation.

Webhook signing key

Request

POST/v1/generations

AuthorizationSend your API key in the Authorization header using the Bearer scheme.Authorization: Bearer ****************

Header Params

stringrequired

A new, stable key for each generation request. Reuse it only when retrying the same request body.

max length: 255

Example:: gpt-image-25-flare-text-001

Body Params

application/json

stringrequired

The model ID shown in the selected model's API documentation.

Allowed:gpt-images-2-5-flare

Default:: gpt-images-2-5-flare
Example:: gpt-images-2-5-flare

stringrequired

Text to Image. Use the Endpoint ID shown in this model's API documentation.

Allowed:text-to-image

Default:: text-to-image
Example:: text-to-image

stringoptional

Select a public processing provider. Omit this field to use the default SeeAPI provider.

The default seeapi provider returns one image per request.
Select fal only when you need its provider-specific quality, background, output format, compression, or native multi-image parameters.
Provider-specific input fields are not interchangeable.

Allowed:seeapifal

Default:: seeapi
Example:: seeapi

objectrequired

Model input validated against the selected Provider form_schema and api_policy.

Provider parameters

SeeAPIseeapiDefault Provider

stringrequired

Describe the image you want to generate, including subject, composition, lighting, style, and any text that must appear.

The prompt must contain 1 to 20,000 characters.

min length: 1max length: 20000

Example:: A modern glass pavilion at sunrise, natural light, architectural photography

stringoptional

Choose the output aspect ratio for the default SeeAPI provider.

Supported values differ by Provider. Use only values listed in the active Provider group.

Allowed:auto1:13:22:34:33:416:99:1621:927:1616:279:88:9

Default:: auto
Example:: 16:9

stringoptional

Choose the output resolution for the default SeeAPI provider.

Supported values are 1K, 2K, and 4K. Higher resolutions consume more credits.
The default SeeAPI provider generates one image per request and does not accept num_output_images.

Allowed:1K2K4K

Default:: 1K
Example:: 2K

stringoptional

Choose automatic, transparent, or opaque image background.

Unsupported background

Allowed:autotransparentopaque

Default:: auto

falfal

stringrequired

Describe the image you want fal to generate, including subject, composition, lighting, style, and required text.

The prompt must contain 1 to 20,000 characters.

min length: 1max length: 20000

Example:: A cinematic city at night

stringoptional

Choose the output aspect ratio for fal.

fal has its own allowed ratio set and defaults to 4:3 for text-to-image. Do not reuse an unsupported SeeAPI-only ratio.

Allowed:auto1:13:49:164:316:9

Default:: 4:3

stringoptional

Choose the fal generation quality level.

Higher quality can increase generation time and credit cost. Allowed values are auto, low, medium, high, xhigh, and max.

Allowed:autolowmediumhighxhighmax

Default:: high

stringoptional

Choose whether fal determines the background automatically or generates an opaque or transparent background.

When background is transparent, output_format must be png or webp. JPEG does not support this combination.

Allowed:autotransparentopaque

Default:: auto

numberoptional

Set the number of images fal should generate in one upstream request.

Flare accepts an integer from 1 to 4. Credit cost scales with the requested count.
The requested count is a maximum;

min: 1max: 4

Default:: 1

numberoptional

Set compression for JPEG or WebP output.

This field is only sent when output_format is jpeg or webp. Use an integer from 0 to 100; the default is 30.
It has no effect for PNG output.

min: 0max: 100

Default:: 30

stringoptional

Choose the fal image output format.

Allowed values are png, jpeg, and webp. When background is transparent, select png or webp; jpeg is rejected.

Allowed:pngjpegwebp

Default:: png

string <uri>optional

An absolute HTTPS URL that receives the terminal generation Webhook.

max length: 2048

Example:: https://client.example.com/webhooks/seeapi

Responses

202Generation accepted and processing

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: gpt-images-2-5-flare

stringrequired

Example:: text-to-image

stringrequired

Allowed:seeapifal

seeapi: SeeAPI
fal: fal

Example:: seeapi

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 10

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200Idempotent replay of an existing generation request

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: gpt-images-2-5-flare

stringrequired

Example:: text-to-image

stringrequired

Allowed:seeapifal

seeapi: SeeAPI
fal: fal

Example:: seeapi

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 10

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Invalid JSON, parameters, Schema, or API Policy

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable

Code Examples

Request

const response = await fetch("https://api.seeapi.com/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Idempotency-Key": "gpt-image-25-flare-text-001",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "gpt-images-2-5-flare",
  "endpoint": "text-to-image",
  "provider": "seeapi",
  "input": {
    "prompt": "A modern glass pavilion at sunrise, natural light, architectural photography",
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "background": "auto"
  },
  "callback_url": "https://client.example.com/webhooks/seeapi"
})
});

const result = await response.json();

ResponseHTTP 202

{
  "generation": {
    "id": "task_xxx",
    "model": "gpt-images-2-5-flare",
    "endpoint": "text-to-image",
    "provider": "seeapi",
    "status": "processing",
    "estimated_credits": 10,
    "consumed_credits": 0,
    "refunded_credits": 0,
    "created_at": "2026-08-18T10:00:00Z",
    "updated_at": "2026-08-18T10:00:00Z"
  },
  "idempotent": false
}

const response = await fetch("https://api.seeapi.com/v1/generations", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Idempotency-Key": "gpt-image-25-flare-text-001", "Content-Type": "application/json" }, body: JSON.stringify({ "model": "gpt-images-2-5-flare", "endpoint": "text-to-image", "provider": "seeapi", "input": { "prompt": "A modern glass pavilion at sunrise, natural light, architectural photography", "aspect_ratio": "16:9", "resolution": "2K", "background": "auto" }, "callback_url": "https://client.example.com/webhooks/seeapi" }) }); const result = await response.json();

{ "generation": { "id": "task_xxx", "model": "gpt-images-2-5-flare", "endpoint": "text-to-image", "provider": "seeapi", "status": "processing", "estimated_credits": 10, "consumed_credits": 0, "refunded_credits": 0, "created_at": "2026-08-18T10:00:00Z", "updated_at": "2026-08-18T10:00:00Z" }, "idempotent": false }

Responses

202Generation accepted and processing

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: gpt-images-2-5-flare

stringrequired

Example:: text-to-image

stringrequired

Allowed:seeapifal

seeapi: SeeAPI
fal: fal

Example:: seeapi

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 10

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200Idempotent replay of an existing generation request

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: gpt-images-2-5-flare

stringrequired

Example:: text-to-image

stringrequired

Allowed:seeapifal

seeapi: SeeAPI
fal: fal

Example:: seeapi

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 10

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Invalid JSON, parameters, Schema, or API Policy

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable