Flux Dev Text to Image

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "blackforestlabs/flux/dev",
  "input": {
    "prompt": "An intimate documentary photograph of an elderly violin restorer in a small lived-in workshop, viewed from slightly above bench height. The craftsman wears a faded indigo work shirt and round spectacles, leaning forward to inspect the curved varnished body of one antique violin resting on a folded linen cloth. One hand steadies the violin gently while the other holds a small inspection light. A large window on the left casts soft directional afternoon daylight across his lined face, amber wood grain, delicate wood shavings, a steel chisel and worn workbench. A few unfinished violin shapes hang softly out of focus in the background. Quiet concentration, believable hands and tools, rich natural material textures, subtle film grain, restrained warm colors, one coherent scene, no staged product display, no lettering, no logos, no watermark.",
    "n": 1,
    "output_format": "png",
    "size": "4:3"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "ZOBDNFN25SVGKU85",
    "status": "running",
    "created_time": "2026-09-25T11:20:26"
  }
}

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/dev",
  "input": {
    "prompt": "An intimate documentary photograph of an elderly violin restorer in a small lived-in workshop, viewed from slightly above bench height. The craftsman wears a faded indigo work shirt and round spectacles, leaning forward to inspect the curved varnished body of one antique violin resting on a folded linen cloth. One hand steadies the violin gently while the other holds a small inspection light. A large window on the left casts soft directional afternoon daylight across his lined face, amber wood grain, delicate wood shavings, a steel chisel and worn workbench. A few unfinished violin shapes hang softly out of focus in the background. Quiet concentration, believable hands and tools, rich natural material textures, subtle film grain, restrained warm colors, one coherent scene, no staged product display, no lettering, no logos, no watermark.",
    "n": 1,
    "output_format": "png",
    "size": "4:3"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "ZOBDNFN25SVGKU85",
    "status": "running",
    "created_time": "2026-09-25T11:20:26"
  }
}

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.

Submit a Task

Send model: "blackforestlabs/flux/dev" and an input object to POST /api/generate/submit. Authenticate with Authorization: Bearer VIDGO_API_KEY.

prompt: Required string. Describe the image or editing instructions using at least one character after trimming.
size: Output canvas, default 1:1. Choose 1:1, 1:1 HD, 4:3, 3:4, 16:9, 9:16, or a custom WIDTHxHEIGHT such as 1024x1536. Custom width and height are positive integers.
n: Positive integer specifying the output image count, default 1.
output_format: png or jpeg, default png.

Retrieve Images

The submission response returns data.task_id. Use Query Task Status to follow the task through not_started, running, finished, or failed. Read image URLs from data.files[].file_url when the status is finished. For failed, read data.error_message. You can provide a top-level callback_url to receive the terminal result through a webhook.

Verified Example

This example was generated through the Vidgo test API. The source and result images are hosted on the Vidgo CDN. The Violin Restorer

{
  "code": 200,
  "data": {
    "task_id": "ZOBDNFN25SVGKU85",
    "status": "finished",
    "files": [
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux/dev/v1/01/output.png",
        "file_type": "image"
      }
    ],
    "created_time": "2026-09-25T11:20:26",
    "error_message": null,
    "progress": 100
  }
}

Authorizations

Authorization

string

header

required

Use Authorization: Bearer VIDGO_API_KEY.

Body

application/json

model

enum<string>

required

Available options:

blackforestlabs/flux/dev

input

object

required

Parameters for text-to-image generation.

Show child attributes

callback_url

string<uri>

Optional webhook callback URL.

Response

Task submitted successfully

code

integer

required

Example:

200

data

object

required

Show child attributes

​Submit a Task

​Retrieve Images

​Verified Example

Authorizations

Body

Response

Submit a Task

Retrieve Images

Verified Example