> ## 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 Kontext Pro Text to Image > Turn natural language descriptions into images with FLUX Kontext Pro, from illustrations to composed scenes and design concepts. 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 Kontext Pro Text to Image Turn natural language descriptions into images with FLUX Kontext Pro, from illustrations to composed scenes and design concepts. ## Available Models * **blackforestlabs/flux-kontext-pro/text-to-image** - Generate images from text prompts. ## Output Options ### Image Size * `size`: Optional. Output aspect ratio. Accepted values: `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `21:9`, `9:21`. Default: `1:1`. ### Output Format * `output_format`: Optional. Output image file format. Accepted values: `png`, `jpg`. ## Key Features * Generate images from text prompts. ## Advanced Parameters Set `model` and optional `callback_url` at the request root. Place all workflow parameters, including output options, inside `input`. ### Prompt * `prompt`: Required. Describe the desired image. Length: **1-2,000 characters**. * Include at least one non-whitespace character. ## 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. ![Storm Chasers on the Kansas Plains](https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-pro/text-to-image/v1/01/output.png) ```json theme={null} { "code": 200, "data": { "task_id": "2M5RH08SQ7GQGKRE", "status": "finished", "files": [ { "file_type": "image", "file_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-pro/text-to-image/v1/01/output.png" } ], "created_time": "2026-09-26T10:59:34", "error_message": null, "progress": 100 } } ``` ## OpenAPI ````yaml api-manual/image-series/blackforestlabs-flux-kontext-pro-text-to-image.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Flux Kontext Pro Text to Image description: >- Turn natural language descriptions into images with FLUX Kontext Pro, from illustrations to composed scenes and design concepts. version: 1.0.0 servers: - url: https://api.vidgo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Image Series summary: Flux Kontext Pro Text to Image description: >- Submit a Flux Kontext Pro Text to Image task with model and optional callback_url at the request root, and generation parameters inside input. operationId: submit_blackforestlabs_flux_kontext_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-kontext-pro/text-to-image enum: - blackforestlabs/flux-kontext-pro/text-to-image input: type: object required: - prompt properties: prompt: type: string maxLength: 2000 minLength: 1 description: >- Describe the image to generate using 1–2,000 characters, including at least one non-whitespace character. size: type: string enum: - '1:1' - '4:3' - '3:4' - '16:9' - '9:16' - '21:9' - '9:21' default: '1:1' description: Output aspect ratio. Defaults to 1:1. output_format: type: string enum: - png - jpg description: 'Output image file format: png or jpg.' additionalProperties: false callback_url: type: string nullable: true description: >- Public HTTP(S) URL that receives a POST notification when the task reaches finished or failed. description: >- Set model and optional callback_url at the request root. Place generation parameters inside input. examples: default: summary: Storm Chasers on the Kansas Plains value: model: blackforestlabs/flux-kontext-pro/text-to-image input: prompt: >- A wide documentary photograph on an empty two-lane gravel road in western Kansas in late June, minutes before a tornado forms. A massive rotating supercell fills the upper two thirds of the sky: a striated, layered mesocyclone shaped like a stacked saucer, dark slate-green underneath, with a low rotating wall cloud on the left side and a thin shaft of hail glowing white behind it. On the right half of the frame, a dusty silver pickup truck is parked on the road shoulder with both front doors open and a tripod-mounted weather instrument mast on its roof. Two storm chasers stand in front of the truck: a tall woman in a faded red windbreaker holds a tablet showing a radar map and points toward the wall cloud; a shorter man in a grey hoodie and baseball cap crouches beside her with a camera on a small tripod. Behind them, golden wheat stubble fields stretch to a flat horizon where a thin strip of warm sunlight breaks under the storm base, lighting the grass and the side of the truck in gold while everything above is dark and heavy. A barbed-wire fence and a leaning wooden utility pole run along the left edge. Strong wind bends the grass and lifts dust from the road. 24mm lens, eye level, sharp foreground, natural color, realistic cloud structure, film grain. No text, no logos, no watermark. size: '16:9' output_format: png pro-text-to-image-02: summary: Travelers at a Snowy Mountain Pass, Ukiyo-e value: model: blackforestlabs/flux-kontext-pro/text-to-image input: prompt: >- A tall vertical Japanese woodblock print illustration with bold saturated printed color, full-bleed so the image fills the entire frame edge to edge with no border, no margin, no title box and no cartouche. At the top, a jagged snow-covered peak stands against a deep Prussian blue sky that fades to pale blue with a bokashi gradient, with falling snow printed as small white dots. In the middle, a zigzag mountain path climbs between snow-laden pine trees with indigo trunks, and a tiny thatched teahouse with a glowing orange paper lantern sits halfway up. At the bottom, exactly three small travelers walk in a line across a wooden plank bridge over a frozen blue stream: first a man in a wide straw hat and straw rain cape leaning on a staff, second a porter with a wooden frame pack, third a man holding the reins of a brown packhorse with a bright vermilion saddle blanket. Flat areas of color, bold black keyblock outlines, visible wood grain in the sky and snow, slight color misregistration. Palette: Prussian blue, indigo, white, soft grey and vermilion accents. Pure image with no characters or writing of any kind. size: '9:21' output_format: jpg pro-text-to-image-03: summary: Antarctic Research Station Cutaway value: model: blackforestlabs/flux-kontext-pro/text-to-image input: prompt: >- A detailed isometric cutaway illustration of a modular Antarctic research station raised on hydraulic stilts above an ice shelf, with the front wall removed to reveal six connected rooms. From left to right: a laboratory with a microscope, sample freezer and ice cores in clear tubes on a rack; a small kitchen with a steaming pot and four people eating at a table; a bunk room with two stacked beds and one person reading; a communications room with a radio operator wearing headphones in front of screens; a gym with a treadmill; and a garage with an orange snowmobile and a tracked vehicle. On the roof: a weather mast with a spinning anemometer, solar panels and a satellite dish. Outside, a blizzard blows snow across the scene, a line of emperor penguins walks past the stilts, and a red flag marks a trail to a distant fuel depot. Clean vector-like line work, soft pastel shading, cool blue-white exterior contrasted with warm yellow interior lighting, consistent isometric perspective, every room clearly readable. No text, no labels, no logos, no watermark. size: '4:3' callback: summary: Receive a completion callback value: model: blackforestlabs/flux-kontext-pro/text-to-image input: prompt: >- A wide documentary photograph on an empty two-lane gravel road in western Kansas in late June, minutes before a tornado forms. A massive rotating supercell fills the upper two thirds of the sky: a striated, layered mesocyclone shaped like a stacked saucer, dark slate-green underneath, with a low rotating wall cloud on the left side and a thin shaft of hail glowing white behind it. On the right half of the frame, a dusty silver pickup truck is parked on the road shoulder with both front doors open and a tripod-mounted weather instrument mast on its roof. Two storm chasers stand in front of the truck: a tall woman in a faded red windbreaker holds a tablet showing a radar map and points toward the wall cloud; a shorter man in a grey hoodie and baseball cap crouches beside her with a camera on a small tripod. Behind them, golden wheat stubble fields stretch to a flat horizon where a thin strip of warm sunlight breaks under the storm base, lighting the grass and the side of the truck in gold while everything above is dark and heavy. A barbed-wire fence and a leaning wooden utility pole run along the left edge. Strong wind bends the grass and lifts dust from the road. 24mm lens, eye level, sharp foreground, natural color, realistic cloud structure, film grain. No text, no logos, no watermark. size: '16:9' output_format: png 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: 2M5RH08SQ7GQGKRE status: running created_time: '2026-09-26T10:59:34' '400': description: Request validation or account balance error 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: Task creation error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '503': description: Model service temporarily unavailable 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. ````