curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gpt-image-2.5-flare",
"input": {
"prompt": "A premium product photo of a silver espresso machine in a bright studio",
"size": "16:9",
"resolution": "2K",
"quality": "medium"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1786751400-abcd1234",
"status": "not_started",
"created_time": "2026-09-09T10:30:00"
}
}OpenAI
GPT Image 2.5 Flare
The GPT Image 2.5 Flare API generates one image from a prompt or edits up to 16 reference images. It is the faster GPT Image 2.5 option and supports masks, transparent backgrounds, and 1K to 4K output.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gpt-image-2.5-flare",
"input": {
"prompt": "A premium product photo of a silver espresso machine in a bright studio",
"size": "16:9",
"resolution": "2K",
"quality": "medium"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1786751400-abcd1234",
"status": "not_started",
"created_time": "2026-09-09T10:30:00"
}
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the result through the unified Query Task Status endpoint.
gpt-image-2.5-flare to generate one image from a prompt or edit up to 16 reference images. A non-empty image_urls array selects editing automatically; omit it or pass an empty array for text-to-image generation.
Parameters
promptis required and supports up to 32,000 characters.quality:low,medium,high(default),xhigh, ormax.background:auto(default),transparent, oropaque.output_format:png(default),jpeg, orwebp. Transparent backgrounds require PNG or WebP.mask_url: optional HTTP(S) mask image URL identifying the area to edit; requires non-emptyimage_urls.- Reference images must use HTTP(S) URLs. Each request produces one output image.
Image Size
sizedefaults to1:1. Supported ratios:1:1,2:3,3:2,4:3,3:4,4:5,5:4,16:9,9:16,21:9.resolutionsupports1K(default),2K, and4K. An omitted size uses a square at the selected tier.- Explicit
size=autois available only with1K; the model determines the image size. Select a ratio or custom size for2Kor4K. - For aspect ratios, actual pixel dimensions may vary by model and generation. Inspect the returned image for exact dimensions; use a custom size when exact pixels are required.
- Custom
WIDTHxHEIGHTsizes require2Kor4K. Both dimensions must be divisible by 16, the longest edge must not exceed 3840, the aspect ratio must not exceed 3:1, and total pixels must be between 655,360 and 8,294,400. A 3840-pixel edge requires4K.
Examples
Text To Image
{
"model": "gpt-image-2.5-flare",
"input": {
"prompt": "A premium product photo of a silver espresso machine in a bright studio",
"size": "16:9",
"resolution": "2K",
"quality": "medium"
}
}
Image Edit
{
"model": "gpt-image-2.5-flare",
"input": {
"prompt": "Keep the product and replace the background with a warm modern studio",
"image_urls": [
"https://example.com/product.png"
],
"size": "1:1",
"quality": "high"
}
}
Mask Edit
{
"model": "gpt-image-2.5-flare",
"input": {
"prompt": "Replace only the masked area with a small vase of flowers",
"image_urls": [
"https://example.com/room.png"
],
"mask_url": "https://example.com/mask.png",
"size": "auto"
}
}
Transparent Background
{
"model": "gpt-image-2.5-flare",
"input": {
"prompt": "A clean cutout of a small silver robot",
"background": "transparent",
"output_format": "webp",
"size": "1:1",
"resolution": "4K",
"quality": "xhigh"
}
}
Authorizations
All API endpoints require Bearer Token authentication
Get your API Key:
Visit the API Key Management Page to get your API Key
Add it to the request header:
Authorization: Bearer YOUR_API_KEY
Body
application/json