Skip to main content
POST
Generate image with GPT Image 2.6 Sunburst
Cutaway illustration of a lighthouse with labeled floors, made with GPT Image 2.6 SunburstMacro photo of a mechanical watch movement with brass gears and red jewels, made with GPT Image 2.6 SunburstArt deco travel poster reading ISLA SERENA with teal mountains and a sailboat, made with GPT Image 2.6 SunburstOverhead mise en place with a handwritten SAFFRON RISOTTO recipe card, made with GPT Image 2.6 Sunburst

GPT Image 2.6 Sunburst 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