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"
}
}Flux
Flux Dev Text to Image
Generate images from a text prompt with preset or custom dimensions and PNG or JPEG output.
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"
}
}Submit a Task
Sendmodel: "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, default1:1. Choose1:1,1:1 HD,4:3,3:4,16:9,9:16, or a customWIDTHxHEIGHTsuch as1024x1536. Custom width and height are positive integers.n: Positive integer specifying the output image count, default1.output_format:pngorjpeg, defaultpng.
Retrieve Images
The submission response returnsdata.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.
{
"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
Use Authorization: Bearer VIDGO_API_KEY.
Body
application/json