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/text-to-image",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"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 Text to Image
Turn written image concepts into square, portrait, or landscape visuals with GPT Image 1.5, with up to four variations per request.
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/text-to-image",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"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 Text to Image
Turn written image concepts into square, portrait, or landscape visuals with GPT Image 1.5, with up to four variations per request.Available Models
- openai/gpt-image-1.5/text-to-image - Generate images from text prompts.
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
- Generate images from text prompts.
- 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 desired image. Length: 1-1,000 characters.- Include at least one non-whitespace character.
Authorizations
Use VIDGO_API_KEY.
Body
application/json
Set model and optional callback_url at the request root. Place generation parameters inside input.