curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "blackforestlabs/flux-kontext-pro/text-to-image",
"input": {
"prompt": "A wide documentary photograph on an empty two-lane gravel road in western Kansas in late June, minutes before a tornado forms. A massive rotating supercell fills the upper two thirds of the sky: a striated, layered mesocyclone shaped like a stacked saucer, dark slate-green underneath, with a low rotating wall cloud on the left side and a thin shaft of hail glowing white behind it. On the right half of the frame, a dusty silver pickup truck is parked on the road shoulder with both front doors open and a tripod-mounted weather instrument mast on its roof. Two storm chasers stand in front of the truck: a tall woman in a faded red windbreaker holds a tablet showing a radar map and points toward the wall cloud; a shorter man in a grey hoodie and baseball cap crouches beside her with a camera on a small tripod. Behind them, golden wheat stubble fields stretch to a flat horizon where a thin strip of warm sunlight breaks under the storm base, lighting the grass and the side of the truck in gold while everything above is dark and heavy. A barbed-wire fence and a leaning wooden utility pole run along the left edge. Strong wind bends the grass and lifts dust from the road. 24mm lens, eye level, sharp foreground, natural color, realistic cloud structure, film grain. No text, no logos, no watermark.",
"size": "16:9",
"output_format": "png"
}
}
'{
"code": 200,
"data": {
"task_id": "2M5RH08SQ7GQGKRE",
"status": "running",
"created_time": "2026-09-26T10:59:34"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Flux
Flux Kontext Pro Text to Image
Turn natural language descriptions into images with FLUX Kontext Pro, from illustrations to composed scenes and design concepts.
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": "blackforestlabs/flux-kontext-pro/text-to-image",
"input": {
"prompt": "A wide documentary photograph on an empty two-lane gravel road in western Kansas in late June, minutes before a tornado forms. A massive rotating supercell fills the upper two thirds of the sky: a striated, layered mesocyclone shaped like a stacked saucer, dark slate-green underneath, with a low rotating wall cloud on the left side and a thin shaft of hail glowing white behind it. On the right half of the frame, a dusty silver pickup truck is parked on the road shoulder with both front doors open and a tripod-mounted weather instrument mast on its roof. Two storm chasers stand in front of the truck: a tall woman in a faded red windbreaker holds a tablet showing a radar map and points toward the wall cloud; a shorter man in a grey hoodie and baseball cap crouches beside her with a camera on a small tripod. Behind them, golden wheat stubble fields stretch to a flat horizon where a thin strip of warm sunlight breaks under the storm base, lighting the grass and the side of the truck in gold while everything above is dark and heavy. A barbed-wire fence and a leaning wooden utility pole run along the left edge. Strong wind bends the grass and lifts dust from the road. 24mm lens, eye level, sharp foreground, natural color, realistic cloud structure, film grain. No text, no logos, no watermark.",
"size": "16:9",
"output_format": "png"
}
}
'{
"code": 200,
"data": {
"task_id": "2M5RH08SQ7GQGKRE",
"status": "running",
"created_time": "2026-09-26T10:59:34"
}
}{
"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.
Flux Kontext Pro Text to Image
Turn natural language descriptions into images with FLUX Kontext Pro, from illustrations to composed scenes and design concepts.Available Models
- blackforestlabs/flux-kontext-pro/text-to-image - Generate images from text prompts.
Output Options
Image Size
size: Optional. Output aspect ratio. Accepted values:1:1,4:3,3:4,16:9,9:16,21:9,9:21. Default:1:1.
Output Format
output_format: Optional. Output image file format. Accepted values:png,jpg.
Key Features
- Generate images from text prompts.
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-2,000 characters.- Include at least one non-whitespace character.
Verified Example
This example was generated through the Vidgo API and is also the default example in the playground. Source and result images are hosted on the Vidgo CDN.
{
"code": 200,
"data": {
"task_id": "2M5RH08SQ7GQGKRE",
"status": "finished",
"files": [
{
"file_type": "image",
"file_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-pro/text-to-image/v1/01/output.png"
}
],
"created_time": "2026-09-26T10:59:34",
"error_message": null,
"progress": 100
}
}
Authorizations
Use VIDGO_API_KEY.
Body
application/json
Set model and optional callback_url at the request root. Place generation parameters inside input.
Available options:
blackforestlabs/flux-kontext-pro/text-to-image Example:
"blackforestlabs/flux-kontext-pro/text-to-image"
Show child attributes
Show child attributes
Public HTTP(S) URL that receives a POST notification when the task reaches finished or failed.