GPT Images 2.5 Sunburst · Image to Image

Apply precision-focused edits with GPT Images 2.5 Sunburst. Use the default SeeAPI provider for single-image 1K–4K output, or select fal for masks, quality, background, compression, and native generation of up to 10 edited images.

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-sunburst-edit-001

Body Params

application/json

stringrequired

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

Allowed:gpt-images-2-5-sunburst

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

stringrequired

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

Allowed:image-to-image

Default:: image-to-image
Example:: image-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 when you need mask-based editing or 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 precision-focused edits to apply while identifying the subjects and details that must remain unchanged.

The prompt must contain 1 to 20,000 characters.

min length: 1max length: 20000

Example:: Refine the materials and reflections for a premium catalog photograph while preserving the product shape

array <uri>required

Provide the source images to edit with the default SeeAPI provider.

Provide 1 to 16 JPEG, PNG, or WebP image URLs.
Each source image can be up to 30 MB.

min items: 1max items: 16

Example:: ["https://client.example.com/product.png"]

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:: auto

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 returns 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 precision-focused edits fal should apply while identifying the subjects and details that must remain unchanged.

The prompt must contain 1 to 20,000 characters.

min length: 1max length: 20000

Example:: A cinematic city at night

array <uri>required

Provide the source images fal should edit.

Provide 1 to 16 JPEG, PNG, or WebP image URLs.
Each source image can be up to 25 MB.

min items: 1max items: 16

Example:: ["https://client.example.com/input.png"]

string <uri>optional

Optionally provide one mask image URL to limit where fal applies the edit.

The mask must have exactly the same width and height as the first input_images item.
The mask image can be JPEG, PNG, or WebP and up to 25 MB.

stringoptional

Choose the output aspect ratio for fal.

For image editing, fal defaults to auto. Its allowed ratio set differs from the default SeeAPI provider.

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

Default:: auto

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 edited images fal should generate in one upstream request.

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

min: 1max: 10

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-sunburst

stringrequired

Example:: image-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-sunburst

stringrequired

Example:: image-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-sunburst-edit-001",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "gpt-images-2-5-sunburst",
  "endpoint": "image-to-image",
  "provider": "seeapi",
  "input": {
    "prompt": "Refine the materials and reflections for a premium catalog photograph while preserving the product shape",
    "input_images": [
      "https://client.example.com/product.png"
    ],
    "aspect_ratio": "auto",
    "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-sunburst",
    "endpoint": "image-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-sunburst-edit-001", "Content-Type": "application/json" }, body: JSON.stringify({ "model": "gpt-images-2-5-sunburst", "endpoint": "image-to-image", "provider": "seeapi", "input": { "prompt": "Refine the materials and reflections for a premium catalog photograph while preserving the product shape", "input_images": [ "https://client.example.com/product.png" ], "aspect_ratio": "auto", "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-sunburst", "endpoint": "image-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-sunburst

stringrequired

Example:: image-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-sunburst

stringrequired

Example:: image-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