Skip to main content
POST
gpt-image-2.5-flare

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
enum<string>
default:gpt-image-2.5-flare
required

Must be one of: gpt-image-2.5-flare. Defaults to gpt-image-2.5-flare.

Available options:
gpt-image-2.5-flare
prompt
string
required

Length must be between 1 and 32000.

Required string length: 1 - 32000
images
string<url>[]

Upload 1 to 16 reference images for image editing.

Required array length: 1 - 16 elements
extends.edit.mask
string<url>

Optional mask for local editing; transparent areas are regenerated.

This field's allowed values depend on: images.

size
string
default:auto

Each side <= 3840, both sides multiples of 16, ratio <= 3:1, total pixels 655360 to 8294400. Defaults to auto.

quality
enum<string>
default:auto

Must be one of: auto, high, low, max, medium, xhigh. Defaults to auto.

Available options:
auto,
high,
low,
max,
medium,
xhigh
max_images
integer
default:1

Must be between 1 and 10. Defaults to 1.

Required range: 1 <= x <= 10
output_format
enum<string>
default:png

Must be one of: jpeg, png, webp. Defaults to png.

Available options:
jpeg,
png,
webp
output_compression
integer

Only valid when output_format is jpeg or webp. Value is in %.

This field's allowed values depend on: output_format.

Required range: 0 <= x <= 100
background
enum<string>
default:auto

Must be one of: auto, opaque, transparent. Defaults to auto.

Conditional limits:

  • transparent background requires png or webp output_format
Available options:
auto,
opaque,
transparent
moderation
enum<string>
default:auto

Must be one of: auto, low. Defaults to auto.

Available options:
auto,
low

Response

Business response. code=0 means the task was accepted; validation failures can return HTTP 200 with code=400.

code
enum<integer>
required
Available options:
0
Example:

0

data
object
required
msg
string
required
Example:

"success"

request_id
string<uuid>
Example:

"250b66dd-e1fb-4bb6-b5f6-c668efadc35d"