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-pro/edit",
  "input": {
    "prompt": "Using image 1 (the grandmother) and image 2 (the boy) as identity references and image 3 as the location, create one warm documentary photograph of the grandmother teaching the boy to fold jiaozi dumplings at the flour-dusted wooden table in the kitchen from image 3. Keep both people exactly recognisable: the grandmother's pinned silver hair with black clip, smile lines, maroon knitted cardigan, white collar and jade earrings; the boy's bowl haircut, missing front tooth, mustard corduroy overalls and striped shirt. The grandmother stands beside and slightly behind the boy, guiding his small hands as he pinches a dumpling closed; a tray of neat finished dumplings and a few lopsided ones sits in front of him, with a rolling pin and a bowl of pork-and-chive filling nearby. Preserve the brick stove, iron wok, bamboo steamer, frosted window with red paper-cuts, and hanging garlic and chillies from image 3. Soft afternoon window light, a little flour in the air, natural skin texture, believable hands, 35mm lens. No text, no watermark.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-pro/edit/v1/01/input-01.png",
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-pro/edit/v1/01/input-02.png",
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-pro/edit/v1/01/input-03.png"
    ],
    "size": "3:2",
    "resolution": "1K"
  }
}
EOF

{
  "code": 200,
  "data": {
    "task_id": "G4SI8DYZSIKS9UV5",
    "status": "running",
    "created_time": "2026-09-26T10:37:28"
  }
}

{
  "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-pro/edit",
  "input": {
    "prompt": "Using image 1 (the grandmother) and image 2 (the boy) as identity references and image 3 as the location, create one warm documentary photograph of the grandmother teaching the boy to fold jiaozi dumplings at the flour-dusted wooden table in the kitchen from image 3. Keep both people exactly recognisable: the grandmother's pinned silver hair with black clip, smile lines, maroon knitted cardigan, white collar and jade earrings; the boy's bowl haircut, missing front tooth, mustard corduroy overalls and striped shirt. The grandmother stands beside and slightly behind the boy, guiding his small hands as he pinches a dumpling closed; a tray of neat finished dumplings and a few lopsided ones sits in front of him, with a rolling pin and a bowl of pork-and-chive filling nearby. Preserve the brick stove, iron wok, bamboo steamer, frosted window with red paper-cuts, and hanging garlic and chillies from image 3. Soft afternoon window light, a little flour in the air, natural skin texture, believable hands, 35mm lens. No text, no watermark.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-pro/edit/v1/01/input-01.png",
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-pro/edit/v1/01/input-02.png",
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-pro/edit/v1/01/input-03.png"
    ],
    "size": "3:2",
    "resolution": "1K"
  }
}
EOF

{
  "code": 200,
  "data": {
    "task_id": "G4SI8DYZSIKS9UV5",
    "status": "running",
    "created_time": "2026-09-26T10:37:28"
  }
}

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

Combine visual references with text instructions in FLUX.2 Pro to edit scenes, transfer styles, and retain recognizable subjects.

Available Models

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

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.

Key Features

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

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

Overview

Chat Series

Image Series

Video Series

Music Series

3D Series

File Management

Task Management

Account Management

FLUX.2 Pro Edit

FLUX.2 Pro Edit

Available Models

Output Options

Image Size

Resolution

Key Features

Advanced Parameters

Prompt

Image URLs

Verified Example

Authorizations

Body

Response

​FLUX.2 Pro Edit

​Available Models

​Output Options

​Image Size

​Resolution

​Key Features

​Advanced Parameters

​Prompt

​Image URLs

​Verified Example

Authorizations

Body

Response

FLUX.2 Pro Edit

Available Models

Output Options

Image Size

Resolution

Key Features

Advanced Parameters

Prompt

Image URLs

Verified Example