FLUX.2 Flex Edit - Vidgo API

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-2-flex/edit",
  "input": {
    "prompt": "Create a children's picture-book illustration. Use image 1 as the exact character design for Pip the robot gardener: the same round teal body, brass spout nose, amber lens eyes, red knitted scarf, yellow rubber boots and tiny brass watering can, with consistent proportions. Place Pip inside the Victorian glasshouse from image 2, standing on the wooden potting bench and carefully watering a row of tomato seedlings in terracotta pots, with the white cast-iron arches, mossy panes and hanging ferns clearly recognisable. Render the whole scene in the risograph print style of image 3: a limited palette of fluorescent pink, teal, sunflower yellow and deep navy, visible grain, halftone dots and slight layer misregistration on off-white paper. Across the top, in large hand-lettered risograph type, the title reads exactly \"PIP AND THE GLASS GARDEN\". No other text, no watermark.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-flex/edit/v1/01/input-01.png",
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-flex/edit/v1/01/input-02.png",
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-flex/edit/v1/01/input-03.png"
    ],
    "size": "3:2",
    "resolution": "1K"
  }
}
EOF

{
  "code": 200,
  "data": {
    "task_id": "E4MB5ERGH360DFJI",
    "status": "running",
    "created_time": "2026-09-26T11:07:59"
  }
}

{
  "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-2-flex/edit",
  "input": {
    "prompt": "Create a children's picture-book illustration. Use image 1 as the exact character design for Pip the robot gardener: the same round teal body, brass spout nose, amber lens eyes, red knitted scarf, yellow rubber boots and tiny brass watering can, with consistent proportions. Place Pip inside the Victorian glasshouse from image 2, standing on the wooden potting bench and carefully watering a row of tomato seedlings in terracotta pots, with the white cast-iron arches, mossy panes and hanging ferns clearly recognisable. Render the whole scene in the risograph print style of image 3: a limited palette of fluorescent pink, teal, sunflower yellow and deep navy, visible grain, halftone dots and slight layer misregistration on off-white paper. Across the top, in large hand-lettered risograph type, the title reads exactly \"PIP AND THE GLASS GARDEN\". No other text, no watermark.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-flex/edit/v1/01/input-01.png",
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-flex/edit/v1/01/input-02.png",
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-flex/edit/v1/01/input-03.png"
    ],
    "size": "3:2",
    "resolution": "1K"
  }
}
EOF

{
  "code": 200,
  "data": {
    "task_id": "E4MB5ERGH360DFJI",
    "status": "running",
    "created_time": "2026-09-26T11:07:59"
  }
}

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

Use FLUX.2 Flex to rework images or combine references, guiding the subject, style, and composition through text.

Models

blackforestlabs/flux-2-flex/edit - Edit images using a prompt and image references.

Features

Edit images using a prompt and image references.
Accepts 1-8 images in image_urls.
Choose from 1K, 2K output resolutions.

Output Options

Image Size

size: Required. Accepted values: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto. auto uses the aspect ratio of the first image in image_urls.

Resolution

resolution: Required. Accepted values: 1K, 2K.

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Send the input fields listed on this page. Each input URL is a public HTTP(S) URL.

Prompt

prompt: Required. Describe the requested changes. Length: 3-5,000 characters.

Image URLs

image_urls: Required. Provide publicly accessible image URLs. Supply 1-8 items. Each item must be an HTTP(S) URL.

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

{
  "code": 200,
  "data": {
    "task_id": "E4MB5ERGH360DFJI",
    "status": "finished",
    "files": [
      {
        "file_type": "image",
        "file_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-flex/edit/v1/01/output.jpg"
      }
    ],
    "created_time": "2026-09-26T11:07:59",
    "error_message": null,
    "progress": 100
  }
}

Authorizations

Authorization

string

header

required

Use VIDGO_API_KEY.

Body

application/json

Keep model and callback_url at the root. Place workflow parameters inside input.

model

string

required

Example:

"blackforestlabs/flux-2-flex/edit"

input

object

required

Show child attributes

callback_url

string | null

Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.

Response

Task submitted

code

enum<integer>

required

Available options:

200

data

object

required

Show child attributes

​Models

​Features

​Output Options

​Image Size

​Resolution

​Advanced Parameters

​Prompt

​Image URLs

​Verified Example

Authorizations

Body

Response

Models

Features

Output Options

Image Size

Resolution

Advanced Parameters

Prompt

Image URLs

Verified Example