curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "openai/gpt-image-2.5-flare/text-to-image",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A product photograph of a silver coffee maker in a bright studio.",
"size": "1:1",
"resolution": "1K"
}
}
'{
"code": 200,
"data": {
"task_id": "task-example-001",
"status": "running",
"created_time": "2026-10-09T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}OpenAI
GPT Image 2.5 Flare Text to Image
Generate one image with GPT Image 2.5 Flare using a text prompt.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "openai/gpt-image-2.5-flare/text-to-image",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A product photograph of a silver coffee maker in a bright studio.",
"size": "1:1",
"resolution": "1K"
}
}
'{
"code": 200,
"data": {
"task_id": "task-example-001",
"status": "running",
"created_time": "2026-10-09T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}- Submit the request with
VIDGO_API_KEY. Atask_idis returned. Keep it until the task reachesfinishedorfailed. - Use Query Task Status to retrieve the result. If you provide a
callback_url, Vidgo sends the result to your webhook when the task finishes or fails.
GPT Image 2.5 Flare Text to Image
Usage Guide
Generate one image with GPT Image 2.5 Flare using a text prompt.- Set
modeltoopenai/gpt-image-2.5-flare/text-to-image. - Place
modeland optionalcallback_urlat the request root; place workflow parameters insideinput. - Each request produces one image.
- For reference-image editing, use Image Edit with
model=openai/gpt-image-2.5-flare/edit.
Parameter Details
promptis required. Supply non-blank text of up to 32,000 characters.sizedefaults to1:1.autois available only withresolution=1K.- Custom
WIDTHxHEIGHTdimensions require2Kor4K. Both edges must be positive multiples of 16, the longest edge must not exceed 3,840 pixels, the aspect ratio must not exceed 3:1, and total pixels must be between 655,360 and 8,294,400. A 3,840-pixel edge requires4K. - A transparent background requires
output_format=pngorwebp.
Developer Notes
- Submission is asynchronous. Use the task status endpoint or a completion webhook to retrieve the final image.
- Billing is per output image and depends on
qualityand the requestedresolutiontier. Aspect-ratio requests keep the selected tier; actual image dimensions may vary. - Credits are deducted on submission and refunded if the task fails.
Optional parameters
size(string): Useauto,1:1,2:3,3:2,4:3,3:4,4:5,5:4,16:9,9:16,21:9, or customWIDTHxHEIGHTdimensions. Default:1:1.resolution(string): Output resolution tier. Accepted values:1K,2K,4K. Default:1K.output_format(string): Output image format. Transparent output requires PNG or WebP. Accepted values:png,jpeg,webp. Default:png.quality(string): Image quality tier. Billing depends on quality and the requested resolution tier. Accepted values:low,medium,high,xhigh,max. Default:high.background(string): Background mode. Transparent output requires PNG or WebP. Accepted values:auto,transparent,opaque. Default:auto.
Authorizations
Use Authorization: Bearer VIDGO_API_KEY.
Body
application/json