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/text-to-image",
  "input": {
    "prompt": "An overhead photograph of an open naturalist's field notebook lying on a sun-warmed basalt rock beside a tide pool. The two cream, lightly textured pages are filled with delicate pencil and watercolour studies: on the left page a purple ochre sea star, a giant green anemone with open tentacles, and a hermit crab in a turban-snail shell; on the right page a cluster of goose barnacles, a small tidepool sculpin, and a strand of rockweed. Each drawing has a neat handwritten ink label: \"Pisaster ochraceus\", \"Anthopleura xanthogrammica\", \"Pagurus samuelis\", \"Pollicipes polymerus\", \"Oligocottus maculosus\", \"Fucus distichus\". Across the top of the left page, the handwritten heading reads exactly \"LOW TIDE 0.3 m - 14 MAY\". Small measurement ticks and fine arrows point to anatomical details. A graphite pencil, a small brass magnifier and a water brush rest on the pages; a few drops of seawater and grains of sand sit near the paper edge. Soft overcast light, true-to-life paper texture, visible watercolour blooms and pencil grain, legible correctly spelled handwriting, no other text, no logos, no watermark.",
    "size": "4:3",
    "resolution": "1K"
  }
}
EOF

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

{
  "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/text-to-image",
  "input": {
    "prompt": "An overhead photograph of an open naturalist's field notebook lying on a sun-warmed basalt rock beside a tide pool. The two cream, lightly textured pages are filled with delicate pencil and watercolour studies: on the left page a purple ochre sea star, a giant green anemone with open tentacles, and a hermit crab in a turban-snail shell; on the right page a cluster of goose barnacles, a small tidepool sculpin, and a strand of rockweed. Each drawing has a neat handwritten ink label: \"Pisaster ochraceus\", \"Anthopleura xanthogrammica\", \"Pagurus samuelis\", \"Pollicipes polymerus\", \"Oligocottus maculosus\", \"Fucus distichus\". Across the top of the left page, the handwritten heading reads exactly \"LOW TIDE 0.3 m - 14 MAY\". Small measurement ticks and fine arrows point to anatomical details. A graphite pencil, a small brass magnifier and a water brush rest on the pages; a few drops of seawater and grains of sand sit near the paper edge. Soft overcast light, true-to-life paper texture, visible watercolour blooms and pencil grain, legible correctly spelled handwriting, no other text, no logos, no watermark.",
    "size": "4:3",
    "resolution": "1K"
  }
}
EOF

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

{
  "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 Flex Text to Image

Explore image concepts with FLUX.2 Flex, using descriptive prompts to shape composition and style in 1K or 2K output.

Available Models

blackforestlabs/flux-2-flex/text-to-image - Generate images from text prompts.

Output Options

Image Size

size: Required. Accepted values: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto.

Resolution

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

Key Features

Generate images from text prompts.
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.

Prompt

prompt: Required. Describe the desired image. Length: 3-5,000 characters.

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. Tide Pool Field Notebook

{
  "code": 200,
  "data": {
    "task_id": "SBR3R4D3GOFPXM1Z",
    "status": "finished",
    "files": [
      {
        "file_type": "image",
        "file_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-flex/text-to-image/v1/02/output.jpg"
      }
    ],
    "created_time": "2026-09-26T11:07:50",
    "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/text-to-image"

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 Flex Text to Image

FLUX.2 Flex Text to Image

Available Models

Output Options

Image Size

Resolution

Key Features

Advanced Parameters

Prompt

Verified Example

Authorizations

Body

Response

​FLUX.2 Flex Text to Image

​Available Models

​Output Options

​Image Size

​Resolution

​Key Features

​Advanced Parameters

​Prompt

​Verified Example

Authorizations

Body

Response

FLUX.2 Flex Text to Image

Available Models

Output Options

Image Size

Resolution

Key Features

Advanced Parameters

Prompt

Verified Example