> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magnific.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit Image

> Generate and edit images using FLUX Kontext Max, the highest-quality tier of Black Forest Labs' Kontext family.

Kontext Max delivers maximum prompt adherence and detail for context-aware image editing. Provide an input image
to guide the transformation, or generate from text alone. Ideal for high-fidelity edits, style changes, and
professional image manipulation where output quality is the priority.




## OpenAPI

````yaml POST /v1/ai/text-to-image/flux-kontext-max
openapi: 3.0.0
info:
  description: >-
    The Magnific API is your gateway to a vast collection of high-quality
    digital resources for your applications and projects. As a leading platform,
    it offers a wide range of graphics, including vectors, photos,
    illustrations, icons, PSD templates, and more, all curated by talented
    designers from around the world.
  title: Magnific API
  version: 1.0.0
servers:
  - description: B2B API Production V1
    url: https://api.magnific.com
security:
  - magnificApiKey: []
paths:
  /v1/ai/text-to-image/flux-kontext-max:
    post:
      tags:
        - text-to-image
      summary: Flux Kontext Max - Edit image from text
      description: >
        Generate and edit images using FLUX Kontext Max, the highest-quality
        tier of Black Forest Labs' Kontext family.


        Kontext Max delivers maximum prompt adherence and detail for
        context-aware image editing. Provide an input image

        to guide the transformation, or generate from text alone. Ideal for
        high-fidelity edits, style changes, and

        professional image manipulation where output quality is the priority.
      operationId: create_image_from_text_flux_kontext_max
      requestBody:
        content:
          application/json:
            examples:
              required-params:
                $ref: '#/components/examples/request-flux-kontext-max-required-params'
              all-params:
                $ref: '#/components/examples/request-flux-kontext-max-all-params'
            schema:
              $ref: '#/components/schemas/ttifkm-request-content'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/create_image_from_text_flux_200_response'
          description: OK - Task created successfully
        '400':
          content:
            application/json:
              examples:
                invalid_page:
                  summary: Parameter 'page' is not valid
                  value:
                    message: Parameter 'page' must be greater than 0
                invalid_query:
                  summary: Parameter 'query' is not valid
                  value:
                    message: Parameter 'query' must not be empty
                invalid_filter:
                  summary: Parameter 'filter' is not valid
                  value:
                    message: Parameter 'filter' is not valid
                generic_bad_request:
                  summary: Bad Request
                  value:
                    message: Parameter ':attribute' is not valid
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response'
            application/problem+json:
              examples:
                invalid_page:
                  summary: Parameter 'page' is not valid
                  value:
                    message: Validation error
                    invalid_params:
                      - field: page
                        reason: Parameter 'page' must be greater than 0
                      - field: per_page
                        reason: Parameter 'per_page' must be greater than 0
              schema:
                $ref: >-
                  #/components/schemas/get_all_style_transfer_tasks_400_response_1
          description: >-
            Bad Request - The server could not understand the request due to
            invalid syntax.
        '401':
          content:
            application/json:
              examples:
                invalid_api_key:
                  summary: API key is not valid
                  value:
                    message: Invalid API key
                missing_api_key:
                  summary: API key is not provided
                  value:
                    message: Missing API key
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response'
          description: >-
            Unauthorized - The client must authenticate itself to get the
            requested response.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_500_response'
          description: >-
            Internal Server Error - The server has encountered a situation it
            doesn't know how to handle.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_503_response'
          description: Service Unavailable
components:
  examples:
    request-flux-kontext-max-required-params:
      summary: Minimal request with required parameters only
      value:
        prompt: turn the sky into a dramatic sunset with orange and purple clouds
        input_image: https://example.com/reference-image.jpg
    request-flux-kontext-max-all-params:
      summary: Complete request with all parameters
      value:
        prompt: >-
          turn the sky into a dramatic sunset with orange and purple clouds,
          cinematic lighting, highly detailed
        input_image: https://example.com/reference-image.jpg
        input_image_2: https://example.com/reference-image-2.jpg
        input_image_3: https://example.com/reference-image-3.jpg
        input_image_4: https://example.com/reference-image-4.jpg
        prompt_upsampling: false
        seed: 42
        guidance: 3
        steps: 50
        aspect_ratio: widescreen_16_9
        safety_tolerance: 2
        output_format: png
        webhook_url: https://your-app.com/webhooks/flux-kontext-max
  schemas:
    ttifkm-request-content:
      properties:
        prompt:
          description: >
            Text description of the image or edit you want to generate.


            **FLUX Kontext Max** is the highest-quality tier of the Kontext
            family, delivering maximum prompt adherence

            and detail for context-aware image editing and generation.


            **Tips for better results:**

            - Be specific about subjects, scenes, and visual details

            - Describe the exact edit or transformation you want

            - Mention lighting, atmosphere, and art style if desired
          example: a beautiful sunset over the ocean with dramatic clouds
          type: string
        input_image:
          description: |
            URL to the input image that guides the generation process.
            The model uses this image as a reference while producing the output.
          example: https://example.com/reference-image.jpg
          format: uri
          type: string
        input_image_2:
          description: >-
            Optional URL to a second reference image. Flux Kontext Max supports
            up to 4 input images.
          example: https://example.com/reference-image-2.jpg
          format: uri
          nullable: true
          type: string
        input_image_3:
          description: >-
            Optional URL to a third reference image. Flux Kontext Max supports
            up to 4 input images.
          example: https://example.com/reference-image-3.jpg
          format: uri
          nullable: true
          type: string
        input_image_4:
          description: >-
            Optional URL to a fourth reference image. Flux Kontext Max supports
            up to 4 input images.
          example: https://example.com/reference-image-4.jpg
          format: uri
          nullable: true
          type: string
        prompt_upsampling:
          default: false
          description: >-
            Whether to perform upsampling on the prompt. If active,
            automatically modifies the prompt for more creative generation.
          type: boolean
        seed:
          description: >-
            Optional seed for reproducibility. If not provided, a random seed
            will be used.
          nullable: true
          type: integer
        guidance:
          default: 3
          description: >-
            Guidance scale for the generation. Higher values make the model
            follow the prompt more closely.
          maximum: 10
          minimum: 1
          nullable: true
          type: number
        steps:
          default: 50
          description: >-
            Number of inference steps. More steps generally produce higher
            quality but take longer.
          maximum: 100
          minimum: 1
          nullable: true
          type: integer
        aspect_ratio:
          default: square_1_1
          description: >
            Image size with the aspect ratio. The aspect ratio is the
            proportional relationship between an image's width and height,
            expressed as *_width_height (e.g., square_1_1, widescreen_16_9). It
            is calculated by dividing the width by the height.\

            If not present, the default is `square_1_1`.
          enum:
            - square_1_1
            - classic_4_3
            - traditional_3_4
            - widescreen_16_9
            - social_story_9_16
            - standard_3_2
            - portrait_2_3
            - horizontal_2_1
            - vertical_1_2
            - social_post_4_5
          example: square_1_1
          type: string
        safety_tolerance:
          default: 2
          description: >-
            Tolerance level for input and output moderation. Between 0 and 6, 0
            being most strict, 6 being least strict.
          maximum: 6
          minimum: 0
          type: integer
        output_format:
          description: Format of the output image
          enum:
            - jpeg
            - png
          nullable: true
          type: string
        webhook_url:
          description: >
            Optional callback URL that will receive asynchronous notifications
            whenever the task changes status. The payload sent to this URL is
            the same as the corresponding GET endpoint response, but without the
            data field.
          example: https://www.example.com/webhook
          format: uri
          type: string
      required:
        - input_image
        - prompt
      type: object
    create_image_from_text_flux_200_response:
      example:
        data:
          task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          status: CREATED
      properties:
        data:
          $ref: '#/components/schemas/task'
      required:
        - data
      type: object
    get_all_style_transfer_tasks_400_response:
      example:
        message: message
      properties:
        message:
          type: string
      type: object
    get_all_style_transfer_tasks_400_response_1:
      properties:
        problem:
          $ref: >-
            #/components/schemas/get_all_style_transfer_tasks_400_response_1_problem
      type: object
    get_all_style_transfer_tasks_500_response:
      example:
        message: Internal Server Error
      properties:
        message:
          example: Internal Server Error
          type: string
      type: object
    get_all_style_transfer_tasks_503_response:
      example:
        message: Service Unavailable. Please try again later.
      properties:
        message:
          example: Service Unavailable. Please try again later.
          type: string
      type: object
    task:
      example:
        task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        status: CREATED
      properties:
        task_id:
          description: Task identifier
          format: uuid
          type: string
        status:
          description: Task status
          enum:
            - CREATED
            - IN_PROGRESS
            - COMPLETED
            - FAILED
          type: string
      required:
        - status
        - task_id
      type: object
    get_all_style_transfer_tasks_400_response_1_problem:
      properties:
        message:
          example: Validation error
          type: string
        invalid_params:
          items:
            $ref: >-
              #/components/schemas/get_all_style_transfer_tasks_400_response_1_problem_invalid_params_inner
          type: array
      required:
        - invalid_params
        - message
      type: object
    get_all_style_transfer_tasks_400_response_1_problem_invalid_params_inner:
      properties:
        name:
          description: Name of the invalid parameter.
          example: page
          type: string
        field:
          description: Field of the invalid parameter. Mirrors `name`.
          example: page
          type: string
        reason:
          example: Parameter 'page' must be greater than 0
          type: string
      required:
        - field
        - name
        - reason
      type: object
  securitySchemes:
    magnificApiKey:
      description: >
        Your Magnific API key. Required for authentication. [Learn how to obtain
        an API key](https://docs.magnific.com/quickstart)
      in: header
      name: x-magnific-api-key
      type: apiKey

````