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",
  "input": {
    "prompt": "Replace the painted name on the bow \"MARISOL\" with \"ALBATROS\". Paint the new letters in the same hand-painted white capital lettering style, same size, same brush texture, with the same chipping and weathering as the rest of the hull. Keep everything else unchanged: the boat, its sky blue hull and white stripe, the rope and buoy, the pebble beach, the palafito stilt houses, the hills, the overcast light and the camera framing.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-pro/v1/02/input-01.png"
    ],
    "size": "16:9",
    "output_format": "jpg"
  }
}
'

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

{
  "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-pro",
  "input": {
    "prompt": "Replace the painted name on the bow \"MARISOL\" with \"ALBATROS\". Paint the new letters in the same hand-painted white capital lettering style, same size, same brush texture, with the same chipping and weathering as the rest of the hull. Keep everything else unchanged: the boat, its sky blue hull and white stripe, the rope and buoy, the pebble beach, the palafito stilt houses, the hills, the overcast light and the camera framing.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-pro/v1/02/input-01.png"
    ],
    "size": "16:9",
    "output_format": "jpg"
  }
}
'

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

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

Edit images with FLUX Kontext Pro using text instructions, with support for character consistency and changes to specific visual details.

Available Models

blackforestlabs/flux-kontext-pro - 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": "KH8OWRITIOASWYGA",
    "status": "finished",
    "files": [
      {
        "file_type": "image",
        "file_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-pro/v1/02/output.jpg"
      }
    ],
    "created_time": "2026-09-26T11:02:37",
    "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-pro

Example:

"blackforestlabs/flux-kontext-pro"

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 Pro Edit

Flux Kontext Pro Edit

Available Models

Output Options

Image Size

Output Format

Key Features

Advanced Parameters

Prompt

Image URLs

Verified Example

Authorizations

Body

Response

​Flux Kontext Pro Edit

​Available Models

​Output Options

​Image Size

​Output Format

​Key Features

​Advanced Parameters

​Prompt

​Image URLs

​Verified Example

Authorizations

Body

Response

Flux Kontext Pro Edit

Available Models

Output Options

Image Size

Output Format

Key Features

Advanced Parameters

Prompt

Image URLs

Verified Example