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/edit",
"input": {
"prompt": "Preserve the product and replace the background with a warm modern studio.",
"image_urls": [
"https://cdn.vidgo.ai/temp/reference-product.png"
],
"size": "1:1",
"resolution": "2K"
}
}
'{
"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 Image Edit
Edit one image with GPT Image 2.5 Flare using text instructions and reference images.
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/edit",
"input": {
"prompt": "Preserve the product and replace the background with a warm modern studio.",
"image_urls": [
"https://cdn.vidgo.ai/temp/reference-product.png"
],
"size": "1:1",
"resolution": "2K"
}
}
'{
"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 Image Edit
Usage Guide
Edit one image with GPT Image 2.5 Flare using text instructions and reference images.- Set
modeltoopenai/gpt-image-2.5-flare/edit. - Place
modeland optionalcallback_urlat the request root; place workflow parameters insideinput. - Each request produces one image.
- For prompt-only generation, use Text to Image with
model=openai/gpt-image-2.5-flare/text-to-image.
Parameter Details
promptis required. Supply non-blank text of up to 32,000 characters.image_urlsis required and accepts 1 to 16 reference image URLs. Use publicly accessible HTTP(S) URLs in the same order as the references in your prompt.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. mask_urlselects the area to edit and requires the reference images inimage_urls.- 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.mask_url(string): Optional mask selecting the area to edit. Requires at least one reference image.
Authorizations
Use Authorization: Bearer VIDGO_API_KEY.
Body
application/json