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-max",
  "input": {
    "prompt": "Move this exact same musician, still seated on the same wooden chair and playing the same cello, from the practice room to the middle of a vast frozen lake at blue hour. Keep his face, curly black hair, round tortoiseshell glasses, closed eyes, moss-green cable-knit sweater with rolled sleeves, charcoal trousers, brown boots, bow position and the honey-brown cello with its worn varnish identical. The new setting: smooth dark ice with white cracks and a light dusting of snow around the chair, snow-covered pine forest and mountains on the far shore, a deep blue twilight sky with a thin pink glow on the horizon and the first stars. A small warm light from a lantern on the ice beside the chair lights his face and the cello, while the rest of the scene is cool blue. His breath is faintly visible in the cold air. Remove the practice room completely.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-max/v1/01/input-01.png"
    ],
    "size": "9:16",
    "output_format": "png"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "QBNW6JCNI530EKJV",
    "status": "running",
    "created_time": "2026-09-26T11:02:47"
  }
}

{
  "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 '
{
  "model": "blackforestlabs/flux-kontext-max",
  "input": {
    "prompt": "Move this exact same musician, still seated on the same wooden chair and playing the same cello, from the practice room to the middle of a vast frozen lake at blue hour. Keep his face, curly black hair, round tortoiseshell glasses, closed eyes, moss-green cable-knit sweater with rolled sleeves, charcoal trousers, brown boots, bow position and the honey-brown cello with its worn varnish identical. The new setting: smooth dark ice with white cracks and a light dusting of snow around the chair, snow-covered pine forest and mountains on the far shore, a deep blue twilight sky with a thin pink glow on the horizon and the first stars. A small warm light from a lantern on the ice beside the chair lights his face and the cello, while the rest of the scene is cool blue. His breath is faintly visible in the cold air. Remove the practice room completely.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-max/v1/01/input-01.png"
    ],
    "size": "9:16",
    "output_format": "png"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "QBNW6JCNI530EKJV",
    "status": "running",
    "created_time": "2026-09-26T11:02:47"
  }
}

{
  "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. A task_id is returned immediately. Keep it until the task reaches finished or failed.
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 Edit

Apply contextual image edits with FLUX Kontext Max, refining subjects and scenes while maintaining visual continuity.

Available Models

blackforestlabs/flux-kontext-max - Edit one source image with a text prompt.

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

Edit one source image with a text prompt.
Provide the source image as a single item in image_urls.

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Input image URLs use HTTP(S) and point to publicly accessible image files.

Prompt

prompt: Required. Describe the requested changes. Length: 1-2,000 characters.
Include at least one non-whitespace character.

Image URLs

image_urls: Required. Provide exactly 1 publicly accessible HTTP(S) image URL as the source image.

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. Source image 1

{
  "code": 200,
  "data": {
    "task_id": "QBNW6JCNI530EKJV",
    "status": "finished",
    "files": [
      {
        "file_type": "image",
        "file_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-max/v1/01/output.png"
      }
    ],
    "created_time": "2026-09-26T11:02:47",
    "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

Example:

"blackforestlabs/flux-kontext-max"

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

Overview

Chat Series

Image Series

Video Series

Music Series

3D Series

File Management

Task Management

Account Management

Flux Kontext Max Edit

Flux Kontext Max Edit

Available Models

Output Options

Image Size

Output Format

Key Features

Advanced Parameters

Prompt

Image URLs

Verified Example

Authorizations

Body

Response

​Flux Kontext Max Edit

​Available Models

​Output Options

​Image Size

​Output Format

​Key Features

​Advanced Parameters

​Prompt

​Image URLs

​Verified Example

Authorizations

Body

Response

Flux Kontext Max Edit

Available Models

Output Options

Image Size

Output Format

Key Features

Advanced Parameters

Prompt

Image URLs

Verified Example