> ## 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 Max Text to Image

> Create images with FLUX Kontext Max, using detailed prompts to direct the subject, visual style, and framing.

<Tip>
  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.
</Tip>

# Flux Kontext Max Text to Image

Create images with FLUX Kontext Max, using detailed prompts to direct the subject, visual style, and framing.

## Available Models

* **blackforestlabs/flux-kontext-max/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.

![Through the Porthole of a Deep-Sea Submersible](https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-max/text-to-image/v1/03/output.png)

```json theme={null}
{
  "code": 200,
  "data": {
    "task_id": "ENZJ08EV0WERQ3QY",
    "status": "finished",
    "files": [
      {
        "file_type": "image",
        "file_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-max/text-to-image/v1/03/output.png"
      }
    ],
    "created_time": "2026-09-26T11:05:02",
    "error_message": null,
    "progress": 100
  }
}
```


## OpenAPI

````yaml api-manual/image-series/blackforestlabs-flux-kontext-max-text-to-image.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: Vidgo API - Flux Kontext Max Text to Image
  description: >-
    Create images with FLUX Kontext Max, using detailed prompts to direct the
    subject, visual style, and framing.
  version: 1.0.0
servers:
  - url: https://api.vidgo.ai
security:
  - BearerAuth: []
paths:
  /api/generate/submit:
    post:
      tags:
        - Image Series
      summary: Flux Kontext Max Text to Image
      description: >-
        Submit a Flux Kontext Max Text to Image task with model and optional
        callback_url at the request root, and generation parameters inside
        input.
      operationId: submit_blackforestlabs_flux_kontext_max_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-max/text-to-image
                  enum:
                    - blackforestlabs/flux-kontext-max/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: Through the Porthole of a Deep-Sea Submersible
                value:
                  model: blackforestlabs/flux-kontext-max/text-to-image
                  input:
                    prompt: >-
                      A photograph taken from inside a small deep-sea research
                      submersible, looking through a thick round acrylic
                      porthole at a depth of 1,200 meters. Outside in the black
                      water, a female deep-sea anglerfish hangs close to the
                      glass, seen from the side: a round lumpy dark-brown body,
                      a huge wide mouth full of long translucent needle teeth,
                      and tiny eyes. Growing out of the top of the fish's own
                      head is a thin, flexible fleshy fishing rod, part of its
                      body, that arches forward over its mouth and ends in a
                      small glowing blue-green bioluminescent bulb, the only
                      strong light source outside. The glow lights the fish's
                      teeth and skin from above. Drifting marine snow particles
                      catch the light. On the inside surface of the porthole,
                      faint reflections of the cabin appear: amber-lit analog
                      gauges, a red emergency switch and the soft silhouette of
                      a scientist's face lit by a tablet screen. Tiny
                      condensation droplets bead on the lower edge of the
                      acrylic. A thick steel ring with heavy hex bolts frames
                      the porthole. Extremely low light, high dynamic range,
                      realistic photographic noise. No text, no logos, no
                      watermark.
                    size: '1:1'
                    output_format: png
              max-text-to-image-01:
                summary: Pitcher Plant Herbarium Plate
                value:
                  model: blackforestlabs/flux-kontext-max/text-to-image
                  input:
                    prompt: >-
                      A single hand-colored botanical plate from a
                      nineteenth-century natural history book, photographed flat
                      and straight on in soft daylight. On warm cream paper with
                      faint foxing, a detailed watercolor and engraving of the
                      carnivorous pitcher plant Nepenthes rajah: one large
                      upright urn-shaped pitcher in deep wine red with
                      yellow-green speckles, a ribbed glossy crimson peristome
                      rim around its mouth, a round lid raised above the
                      opening, and a curling tendril joining the base of the
                      pitcher to the tip of a long leathery green leaf. Next to
                      it, a small cutaway of the pitcher shows digestive fluid
                      and a trapped beetle. Delicate engraved line hatching,
                      soft watercolor washes and blooms, fine paper fibers and a
                      slightly uneven plate-mark border. At the top center, one
                      single line of elegant engraved serif capitals reads
                      exactly "NEPENTHES RAJAH". That title is the only text on
                      the page: there are no numbers, labels, captions,
                      signatures, stamps or handwriting anywhere else.
                    size: '3:4'
                    output_format: png
              max-text-to-image-02:
                summary: Salt Caravan at Dawn in the Danakil
                value:
                  model: blackforestlabs/flux-kontext-max/text-to-image
                  input:
                    prompt: >-
                      An ultra-wide cinematic panorama of the Danakil Depression
                      in Ethiopia at dawn. A long camel caravan of about twenty
                      camels, each loaded with stacked rectangular slabs of
                      white salt tied with rope, walks in single file from left
                      to right across a vast, perfectly flat salt pan. Afar
                      herders in white and ochre wraps walk beside the camels
                      holding long sticks. The low sun sits just above the
                      horizon on the right, casting very long blue shadows of
                      the camels across the cracked hexagonal salt crust and
                      turning the ground into a gradient of pink, apricot and
                      pale lilac. A thin layer of standing water in the
                      foreground mirrors the caravan and the sky. Distant dark
                      volcanic hills line the horizon under a clear sky fading
                      from peach to deep blue with a few high streaks of cloud.
                      Shot on an anamorphic lens, low camera height, gentle heat
                      haze, fine detail in the salt texture and camel fur,
                      realistic scale. No text, no logos, no watermark.
                    size: '21:9'
                    output_format: jpg
              callback:
                summary: Receive a completion callback
                value:
                  model: blackforestlabs/flux-kontext-max/text-to-image
                  input:
                    prompt: >-
                      A photograph taken from inside a small deep-sea research
                      submersible, looking through a thick round acrylic
                      porthole at a depth of 1,200 meters. Outside in the black
                      water, a female deep-sea anglerfish hangs close to the
                      glass, seen from the side: a round lumpy dark-brown body,
                      a huge wide mouth full of long translucent needle teeth,
                      and tiny eyes. Growing out of the top of the fish's own
                      head is a thin, flexible fleshy fishing rod, part of its
                      body, that arches forward over its mouth and ends in a
                      small glowing blue-green bioluminescent bulb, the only
                      strong light source outside. The glow lights the fish's
                      teeth and skin from above. Drifting marine snow particles
                      catch the light. On the inside surface of the porthole,
                      faint reflections of the cabin appear: amber-lit analog
                      gauges, a red emergency switch and the soft silhouette of
                      a scientist's face lit by a tablet screen. Tiny
                      condensation droplets bead on the lower edge of the
                      acrylic. A thick steel ring with heavy hex bolts frames
                      the porthole. Extremely low light, high dynamic range,
                      realistic photographic noise. No text, no logos, no
                      watermark.
                    size: '1:1'
                    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: ENZJ08EV0WERQ3QY
                  status: running
                  created_time: '2026-09-26T11:05:02'
        '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.

````