Skip to main content
POST
Generate image with GPT Image 2.6 Flare
Cafe window with a hand-lettered FRESH BAGELS sign and a neon OPEN sign, made with GPT Image 2.6 FlareFlat illustration of a cat asleep on a window seat in a cozy reading nook, made with GPT Image 2.6 FlareOrange running shoe bursting through a splash of colored powder, made with GPT Image 2.6 FlareRisograph-style poster reading MAKE IT TODAY with bold geometric shapes, made with GPT Image 2.6 Flare

GPT Image 2.6 Flare on BudgetPixel

More examples, prompts and pricing.

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
prompt
string
required

Text description of the image to generate. Write @handle to cast a character: a BudgetPixel AI influencer or one of your own (GET /v1/characters).

aspect_ratio
enum<string>
default:1:1

Output aspect ratio.

Available options:
1:1,
3:2,
2:3,
4:3,
3:4,
16:9,
9:16,
auto
background
enum<string>
default:auto

Output background. transparent returns a cut-out with a transparent background, from text or an edit (as PNG, or WebP if asked: JPEG has no transparency). auto lets the model decide.

Available options:
auto,
opaque,
transparent
complexity
enum<string>
default:high

How much the model plans before it renders. high suits dense text, complex layouts and scenes where objects relate to each other; medium and low plan less, are faster, and suit focused edits such as changing a background or a sign. Does not change the price.

Available options:
low,
medium,
high
num_images
integer
default:1

Number of images to generate.

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

Output image format.

Available options:
png,
jpeg,
webp
quality
enum<string>
default:medium

Rendering detail. Per image, at any size: low 70, medium 120, high 175, xhigh 340, max 675 credits.

Available options:
low,
medium,
high,
xhigh,
max
reference_images
string[]

Optional reference images (up to 16) to edit or combine into one image. Each item is a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Omit for text-to-image. References do not change the price.

Maximum array length: 16
resolution
enum<string>
default:1K

Output size tier; the price is the same at every size. 1:1 renders 1024x1024 at 1K and 2048x2048 at 2K or 4K. 16:9 and 9:16 render 2048x1152 / 1152x2048 at 1K or 2K, and 3840x2160 / 2160x3840 at 4K. 3:2, 2:3, 4:3 and 3:4 have one size each (1536x1024, 1024x1536, 1536x1152, 1152x1536). With aspect_ratio auto the model picks the size, and an edit keeps its input's shape.

Available options:
1K,
2K,
4K

Response

Job accepted.

characters
object[]

The characters the prompt cast with @handle mentions. Absent when none.

id
string

Opaque job id — use it to poll status.

Example:

"img_a1b2c3d4e5f6"

message
string
model
string
status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout