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/text-to-image",
"input": {
"prompt": "A candid documentary photograph taken at night on the open deck of a small wooden river ferry crossing a wide Southeast Asian river in steady monsoon rain. In the foreground, a middle-aged woman in a translucent green raincoat steadies a dented red motor scooter by its handlebars. Behind her, an elderly man in a conical straw hat shares a folded black umbrella with a schoolgirl in a navy uniform who clutches a paper bag against her chest. At the far right, a young deckhand in rubber boots coils a wet mooring rope. A single sodium-vapor lamp above the wheelhouse casts warm orange light that falls off into deep blue darkness; distant city lights on the far bank blur into soft bokeh and long wavering reflections on the black water. Diagonal rain streaks catch the lamplight, beads of water cling to the scooter's chrome mirror, and the worn deck planks shine with puddles reflecting the lamp. 35mm lens at eye level, shallow depth of field focused on the woman's face, natural skin texture, believable hands, subtle film grain, a quiet and patient mood. No text, no signage, no logos, no watermark.",
"size": "3:2",
"resolution": "1K"
}
}
EOF{
"code": 200,
"data": {
"task_id": "FUI8N7NW2JLV34RB",
"status": "running",
"created_time": "2026-09-26T10:30:10"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Flux
FLUX.2 Pro Text to Image
Create detailed images with FLUX.2 Pro, using natural language to direct subjects, composition, and visible text at up to 2K.
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/text-to-image",
"input": {
"prompt": "A candid documentary photograph taken at night on the open deck of a small wooden river ferry crossing a wide Southeast Asian river in steady monsoon rain. In the foreground, a middle-aged woman in a translucent green raincoat steadies a dented red motor scooter by its handlebars. Behind her, an elderly man in a conical straw hat shares a folded black umbrella with a schoolgirl in a navy uniform who clutches a paper bag against her chest. At the far right, a young deckhand in rubber boots coils a wet mooring rope. A single sodium-vapor lamp above the wheelhouse casts warm orange light that falls off into deep blue darkness; distant city lights on the far bank blur into soft bokeh and long wavering reflections on the black water. Diagonal rain streaks catch the lamplight, beads of water cling to the scooter's chrome mirror, and the worn deck planks shine with puddles reflecting the lamp. 35mm lens at eye level, shallow depth of field focused on the woman's face, natural skin texture, believable hands, subtle film grain, a quiet and patient mood. No text, no signage, no logos, no watermark.",
"size": "3:2",
"resolution": "1K"
}
}
EOF{
"code": 200,
"data": {
"task_id": "FUI8N7NW2JLV34RB",
"status": "running",
"created_time": "2026-09-26T10:30:10"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the result through the unified Query Task Status endpoint.
Models
- blackforestlabs/flux-2-pro/text-to-image - Generate images from text prompts.
Features
- Generate images from text prompts.
- Choose from
1K,2Koutput resolutions.
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.
Advanced Parameters
Setmodel 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.
{
"code": 200,
"data": {
"task_id": "FUI8N7NW2JLV34RB",
"status": "finished",
"files": [
{
"file_type": "image",
"file_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-pro/text-to-image/v1/01/output.jpg"
}
],
"created_time": "2026-09-26T10:30:10",
"error_message": null,
"progress": 100
}
}
Authorizations
Use VIDGO_API_KEY.
Body
application/json
Keep model and callback_url at the root. Place workflow parameters inside input.