Skip to main content
POST
Submit GPT Image 2.5 task

Submit task

prompt is required. Omit image_urls for generation, or provide up to 16 HTTP(S) URLs or base64 data URIs (JPEG, PNG, or WebP) for editing. version selects flare (default) or sunburst. Each accepted request produces one image.
The gateway charges per image by resolution: 1K = 13, 2K = 21, 4K = 32 credits. version, aspect_ratio, and reference images do not change the price. Read /pricing for the current amount.

Authorizations

Authorization
string
header
required

Wizzx API key. This is not a JWT.

Body

application/json

Omit image_urls for text-to-image; provide 1-16 images for image-to-image editing. One image per request. version, aspect_ratio, and reference images do not change the price.

prompt
string
required

Required prompt. The gateway enforces a 20000-byte UTF-8 limit.

Minimum string length: 1
version
enum<string>
default:flare

flare is faster; sunburst gives finer edits for product, ad, and multi-turn editing. Same price.

Available options:
flare,
sunburst
image_urls
string[]
Maximum array length: 16

HTTP(S) URL or base64 data URI. JPEG, PNG, or WebP only.

Pattern: ^(https?://|data:image/(jpeg|png|webp);base64,)
aspect_ratio
enum<string>
default:auto
Available options:
auto,
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3,
5:4,
4:5,
21:9
resolution
enum<string>
default:1K

Billed per image: 1K = 13, 2K = 21, 4K = 32 credits.

Available options:
1K,
2K,
4K

Response

Task accepted

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

"success"

data
object
required
request_id
string<uuid>
required