> ## 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 Edit

> Apply contextual image edits with FLUX Kontext Max, refining subjects and scenes while maintaining visual continuity.

<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 Edit

Apply contextual image edits with FLUX Kontext Max, refining subjects and scenes while maintaining visual continuity.

## Available Models

* **blackforestlabs/flux-kontext-max** - Edit one source image with a text prompt.

## 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

* Edit one source image with a text prompt.
* Provide the source image as a single item in `image_urls`.

## Advanced Parameters

Set `model` and optional `callback_url` at the request root. Place all workflow parameters, including output options, inside `input`.

Input image URLs use HTTP(S) and point to publicly accessible image files.

### Prompt

* `prompt`: Required. Describe the requested changes. Length: **1-2,000 characters**.
* Include at least one non-whitespace character.

### Image URLs

* `image_urls`: Required. Provide exactly 1 publicly accessible HTTP(S) image URL as the source image.

## 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.

![Source image 1](https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-max/v1/01/input-01.png)

![Same Cellist on a Frozen Lake](https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-max/v1/01/output.png)

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


## OpenAPI

````yaml api-manual/image-series/blackforestlabs-flux-kontext-max.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: Vidgo API - Flux Kontext Max Edit
  description: >-
    Apply contextual image edits with FLUX Kontext Max, refining subjects and
    scenes while maintaining visual continuity.
  version: 1.0.0
servers:
  - url: https://api.vidgo.ai
security:
  - BearerAuth: []
paths:
  /api/generate/submit:
    post:
      tags:
        - Image Series
      summary: Flux Kontext Max Edit
      description: >-
        Submit a Flux Kontext Max Edit task with model and optional callback_url
        at the request root, and generation parameters inside input.
      operationId: submit_blackforestlabs_flux_kontext_max
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - input
              additionalProperties: true
              properties:
                model:
                  type: string
                  example: blackforestlabs/flux-kontext-max
                  enum:
                    - blackforestlabs/flux-kontext-max
                input:
                  type: object
                  required:
                    - image_urls
                    - prompt
                  properties:
                    prompt:
                      type: string
                      maxLength: 2000
                      minLength: 1
                      description: >-
                        Describe the requested image changes using 1–2,000
                        characters, including at least one non-whitespace
                        character.
                    image_urls:
                      type: array
                      items:
                        type: string
                        format: uri
                        description: Publicly accessible HTTP(S) image URL.
                      minItems: 1
                      maxItems: 1
                      description: >-
                        Source image to edit. Supply exactly 1 publicly
                        accessible HTTP(S) image URL.
                    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: Same Cellist on a Frozen Lake
                value:
                  model: blackforestlabs/flux-kontext-max
                  input:
                    prompt: >-
                      Move this exact same musician, still seated on the same
                      wooden chair and playing the same cello, from the practice
                      room to the middle of a vast frozen lake at blue hour.
                      Keep his face, curly black hair, round tortoiseshell
                      glasses, closed eyes, moss-green cable-knit sweater with
                      rolled sleeves, charcoal trousers, brown boots, bow
                      position and the honey-brown cello with its worn varnish
                      identical. The new setting: smooth dark ice with white
                      cracks and a light dusting of snow around the chair,
                      snow-covered pine forest and mountains on the far shore, a
                      deep blue twilight sky with a thin pink glow on the
                      horizon and the first stars. A small warm light from a
                      lantern on the ice beside the chair lights his face and
                      the cello, while the rest of the scene is cool blue. His
                      breath is faintly visible in the cold air. Remove the
                      practice room completely.
                    image_urls:
                      - >-
                        https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-max/v1/01/input-01.png
                    size: '9:16'
                    output_format: png
              max-edit-02:
                summary: Icelandic Turf Farm as a Stained-Glass Window
                value:
                  model: blackforestlabs/flux-kontext-max
                  input:
                    prompt: >-
                      Transform this photograph into a traditional leaded
                      stained-glass window. Keep the exact composition: the four
                      turf-roofed houses with white fronts and red doors, the
                      stone wall, the gravel path, the waterfall on the basalt
                      cliff, the sheep and the cloudy sky, all in the same
                      positions. Render every shape as pieces of colored
                      cathedral glass separated by thick dark lead came lines,
                      with deep emerald and moss greens for the grass roofs and
                      meadow, cobalt and pale blue glass for the sky and
                      waterfall, ruby red for the doors, and milky white glass
                      for the house fronts and sheep. Show light shining through
                      the glass with subtle bubbles, streaks and uneven
                      thickness, and a thin dark iron frame around the whole
                      window.
                    image_urls:
                      - >-
                        https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-max/v1/02/input-01.png
                    size: '1:1'
                    output_format: jpg
              max-edit-03:
                summary: Restoring an Old Rice-Terrace Photograph
                value:
                  model: blackforestlabs/flux-kontext-max
                  input:
                    prompt: >-
                      Restore and colorize this old photograph. Remove all dust
                      specks, scratches and the diagonal crease, and repair the
                      torn corner so the scene continues naturally. Recover
                      sharp detail and natural contrast. Colorize realistically:
                      vivid young green rice seedlings, muddy brown-green water
                      reflecting a pale blue sky, warm natural skin tones, faded
                      indigo and red traditional woven clothing, grey stone
                      terrace walls with green moss, lush green mountainside and
                      soft white mist on the peaks. Keep the three farmers'
                      faces, poses, hands, positions and the composition exactly
                      the same as the original.
                    image_urls:
                      - >-
                        https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-max/v1/03/input-01.png
                    size: '4:3'
              callback:
                summary: Receive a completion callback
                value:
                  model: blackforestlabs/flux-kontext-max
                  input:
                    prompt: >-
                      Move this exact same musician, still seated on the same
                      wooden chair and playing the same cello, from the practice
                      room to the middle of a vast frozen lake at blue hour.
                      Keep his face, curly black hair, round tortoiseshell
                      glasses, closed eyes, moss-green cable-knit sweater with
                      rolled sleeves, charcoal trousers, brown boots, bow
                      position and the honey-brown cello with its worn varnish
                      identical. The new setting: smooth dark ice with white
                      cracks and a light dusting of snow around the chair,
                      snow-covered pine forest and mountains on the far shore, a
                      deep blue twilight sky with a thin pink glow on the
                      horizon and the first stars. A small warm light from a
                      lantern on the ice beside the chair lights his face and
                      the cello, while the rest of the scene is cool blue. His
                      breath is faintly visible in the cold air. Remove the
                      practice room completely.
                    image_urls:
                      - >-
                        https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-kontext-max/v1/01/input-01.png
                    size: '9:16'
                    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: QBNW6JCNI530EKJV
                  status: running
                  created_time: '2026-09-26T11:02:47'
        '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.

````