> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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. 1. Submit the request with `VIDGO_API_KEY`. A `task_id` is returned immediately. Keep it until the task reaches `finished` or `failed`. 2. Use [Query Task Status](/api-manual/task-management/status) to retrieve the result. If you provide a `callback_url`, Vidgo sends the result to your [webhook](/api-manual/task-management/webhooks) when the task finishes or fails. # 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. ## Available Models * **blackforestlabs/flux-2-pro/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. ![Night Ferry in the Rain](https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-pro/text-to-image/v1/01/output.jpg) ```json theme={null} { "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 } } ``` ## OpenAPI ````yaml api-manual/image-series/blackforestlabs-flux-2-pro-text-to-image.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - FLUX.2 Pro Text to Image description: >- Create detailed images with FLUX.2 Pro, using natural language to direct subjects, composition, and visible text at up to 2K. version: 1.0.0 servers: - url: https://api.vidgo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Image Series summary: FLUX.2 Pro Text to Image description: >- Send the fields shown for this workflow. Place `prompt`, `size`, and `resolution` inside `input`. operationId: submit_blackforestlabs_flux_2_pro_text_to_image requestBody: required: true content: application/json: schema: type: object required: - model - input additionalProperties: true properties: model: type: string example: blackforestlabs/flux-2-pro/text-to-image input: type: object required: - prompt - resolution - size properties: prompt: type: string minLength: 3 maxLength: 5000 description: >- Text description of the image to generate, 3-5,000 characters. size: type: string enum: - '1:1' - '4:3' - '3:4' - '16:9' - '9:16' - '3:2' - '2:3' - auto description: Aspect ratio of the output image. resolution: type: string enum: - 1K - 2K description: Output image resolution. additionalProperties: false callback_url: type: string nullable: true description: >- Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks. description: >- Keep model and callback_url at the root. Place workflow parameters inside input. examples: default: summary: Night Ferry in the Rain value: 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 pro-text-to-image-02: summary: Morning Inside a Mongolian Ger value: model: blackforestlabs/flux-2-pro/text-to-image input: prompt: >- An interior photograph of a traditional Mongolian ger on a cold clear morning, viewed from just inside the low wooden door toward the back wall. Pale sunlight enters through the circular roof crown and forms a bright shaft through faint stove smoke. Exact colour palette: the painted roof crown ring and the radiating roof poles are lacquered in #C8102E crimson with fine #F2A900 saffron-yellow geometric knot patterns; the two central support columns are painted #1B4D89 deep blue; the felt walls are undyed #EDE3D1 wool cream; the floor carpet is #7A2E1F madder brown with cream borders. A cast-iron stove with a steaming kettle stands in the centre, a low painted table holds two small bowls of milk tea, and a folded deel robe lies on a wooden bed at the left. Every coloured surface matches the specified hex values under natural daylight, with authentic hand-painted brush texture, wool fibre detail and soft bounce light. Documentary interior photography, 24mm lens, no people, no text, no logos, no watermark. size: '4:3' resolution: 1K pro-text-to-image-03: summary: Tunnel Boring Crew value: model: blackforestlabs/flux-2-pro/text-to-image input: prompt: >- A wide-angle industrial documentary photograph deep underground in a newly excavated metro tunnel. The enormous circular cutterhead of a tunnel boring machine, about twelve metres across, fills the right half of the frame, its steel disc cutters worn and caked with damp grey clay. Three workers in orange high-visibility overalls, white helmets with headlamps and mud-streaked boots inspect the cutters from a narrow steel gantry at mid-height: one points a flashlight at a chipped cutter, one takes notes on a clipboard, and the third holds a long torque wrench. Along the left, curved precast concrete tunnel rings recede into the distance, lit by a string of cool-white work lights that create repeating pools of light and hard shadows. Water drips from the tunnel crown and glistens on the rails of a small muck-removal train. Strong sense of scale between people and machine, realistic steel, concrete and clay textures, humid haze catching the light beams, truthful colour. No brand names, no lettering on the machine or clothing, no watermark. size: '16:9' resolution: 1K callback: summary: Receive a completion callback value: 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 callback_url: https://your-domain.com/callback responses: '200': description: Task submitted content: application/json: schema: type: object required: - code - data properties: code: type: integer enum: - 200 data: type: object required: - task_id - status - created_time properties: task_id: type: string status: type: string enum: - not_started - running - finished - failed created_time: type: string format: date-time example: code: 200 data: task_id: FUI8N7NW2JLV34RB status: running created_time: '2026-09-26T10:30:10' '400': description: Invalid input, inaccessible media, or insufficient credits content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '401': description: Invalid credentials content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '403': description: Access denied content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '404': description: Unknown or disabled model content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '408': description: Request timed out content: text/plain: schema: type: string example: Request timeout '422': description: Invalid JSON or non-object request body content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '429': description: Rate or API key credit limit exceeded content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '500': description: Internal error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '502': description: Unable to create the generation task content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '503': description: Model configuration or capability is not approved content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} components: securitySchemes: BearerAuth: type: http scheme: bearer description: Use VIDGO_API_KEY. ````