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-1.5/edit",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"prompt": "Replace the sky with a starry night sky.",
"size": "1024x1024",
"n": 1
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}OpenAI
GPT Image 1.5 Edit
Make targeted image changes with GPT Image 1.5 using text instructions, reference images, and optional masks for selected areas.
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-1.5/edit",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"prompt": "Replace the sky with a starry night sky.",
"size": "1024x1024",
"n": 1
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- Submit the request with
VIDGO_API_KEY. Atask_idis returned immediately. 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 1.5 Edit
Make targeted image changes with GPT Image 1.5 using text instructions, reference images, and optional masks for selected areas.Available Models
- openai/gpt-image-1.5/edit - Edit images using a prompt and image references.
Output Options
Image Size
size: Optional. Accepted values:1024x1024,1024x1536,1536x1024. Default:1024x1024.
Image Count
n: Optional. Number of images to generate. Accepted values:1,2,3,4. Default:1.
Key Features
- Edit images using a prompt and image references.
- Accepts at least 1 image in
image_urls. - Control the number of output images with
n.
Advanced Parameters
Setmodel and optional callback_url at the request root. Place all workflow parameters, including output options, inside input.
Prompt
prompt: Required. Describe the requested changes. Length: 1-1,000 characters.- Include at least one non-whitespace character.
Image URLs
image_urls: Required. Provide publicly accessible image URLs. Supply at least 1 item. Each item must be an HTTP(S) URL.
Mask URL
mask_url: Optional. Publicly accessible HTTP(S) URL of a mask image that selects the area to edit.
Authorizations
Use VIDGO_API_KEY.
Body
application/json
Set model and optional callback_url at the request root. Place generation parameters inside input.