curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"model": "blackforestlabs/flux-kontext-max/text-to-image",
"input": {
"prompt": "A photograph taken from inside a small deep-sea research submersible, looking through a thick round acrylic porthole at a depth of 1,200 meters. Outside in the black water, a female deep-sea anglerfish hangs close to the glass, seen from the side: a round lumpy dark-brown body, a huge wide mouth full of long translucent needle teeth, and tiny eyes. Growing out of the top of the fish's own head is a thin, flexible fleshy fishing rod, part of its body, that arches forward over its mouth and ends in a small glowing blue-green bioluminescent bulb, the only strong light source outside. The glow lights the fish's teeth and skin from above. Drifting marine snow particles catch the light. On the inside surface of the porthole, faint reflections of the cabin appear: amber-lit analog gauges, a red emergency switch and the soft silhouette of a scientist's face lit by a tablet screen. Tiny condensation droplets bead on the lower edge of the acrylic. A thick steel ring with heavy hex bolts frames the porthole. Extremely low light, high dynamic range, realistic photographic noise. No text, no logos, no watermark.",
"size": "1:1",
"output_format": "png"
}
}
EOF{
"code": 200,
"data": {
"task_id": "ENZJ08EV0WERQ3QY",
"status": "running",
"created_time": "2026-09-26T11:05:02"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Flux
Flux Kontext Max Text to Image
Create images with FLUX Kontext Max, using detailed prompts to direct the subject, visual style, and framing.
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 @- <<EOF
{
"model": "blackforestlabs/flux-kontext-max/text-to-image",
"input": {
"prompt": "A photograph taken from inside a small deep-sea research submersible, looking through a thick round acrylic porthole at a depth of 1,200 meters. Outside in the black water, a female deep-sea anglerfish hangs close to the glass, seen from the side: a round lumpy dark-brown body, a huge wide mouth full of long translucent needle teeth, and tiny eyes. Growing out of the top of the fish's own head is a thin, flexible fleshy fishing rod, part of its body, that arches forward over its mouth and ends in a small glowing blue-green bioluminescent bulb, the only strong light source outside. The glow lights the fish's teeth and skin from above. Drifting marine snow particles catch the light. On the inside surface of the porthole, faint reflections of the cabin appear: amber-lit analog gauges, a red emergency switch and the soft silhouette of a scientist's face lit by a tablet screen. Tiny condensation droplets bead on the lower edge of the acrylic. A thick steel ring with heavy hex bolts frames the porthole. Extremely low light, high dynamic range, realistic photographic noise. No text, no logos, no watermark.",
"size": "1:1",
"output_format": "png"
}
}
EOF{
"code": 200,
"data": {
"task_id": "ENZJ08EV0WERQ3QY",
"status": "running",
"created_time": "2026-09-26T11:05:02"
}
}{
"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 Max Text to Image
Create images with FLUX Kontext Max, using detailed prompts to direct the subject, visual style, and framing.Available Models
- blackforestlabs/flux-kontext-max/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": "ENZJ08EV0WERQ3QY",
"status": "finished",
"files": [
{
"file_type": "image",
"file_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-max/text-to-image/v1/03/output.png"
}
],
"created_time": "2026-09-26T11:05:02",
"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-max/text-to-image Example:
"blackforestlabs/flux-kontext-max/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.