Flux Kontext Max Text to Image

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>"
}

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>"
}

After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

Create images with FLUX Kontext Max, using detailed prompts to direct the subject, visual style, and framing.

Models

blackforestlabs/flux-kontext-max/text-to-image - Generate images from text prompts.

Features

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.

Advanced Parameters

Set model 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. Through the Porthole of a Deep-Sea Submersible

Through the Porthole of a Deep-Sea Submersible

{
  "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

Authorization

string

header

required

Use VIDGO_API_KEY.

Body

application/json

Set model and optional callback_url at the request root. Place generation parameters inside input.

model

enum<string>

required

Available options:

blackforestlabs/flux-kontext-max/text-to-image

Example:

"blackforestlabs/flux-kontext-max/text-to-image"

input

object

required

Show child attributes

callback_url

string | null

Public HTTP(S) URL that receives a POST notification when the task reaches finished or failed.

Response

Task submitted

code

enum<integer>

required

Available options:

200

data

object

required

Show child attributes

​Models

​Features

​Output Options

​Image Size

​Output Format

​Advanced Parameters

​Prompt

​Verified Example

Authorizations

Body

Response

Models

Features

Output Options

Image Size

Output Format

Advanced Parameters

Prompt

Verified Example