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

# Flux 2 Turbo - Create image from text

> Create high-quality images quickly using FLUX.2 [turbo], the speed-optimized version of Flux 2.

**Key Features:**
- Fast generation (optimized for speed)
- Lower cost than Pro version
- Adjustable guidance scale for prompt adherence
- Custom image dimensions (512-2048px)
- Safety checker for content filtering
- Multiple output formats (PNG/JPEG)

**Use Cases:**
- Rapid prototyping and iteration
- Content exploration
- High-volume generation
- Testing prompts and concepts




## OpenAPI

````yaml post /v1/ai/text-to-image/flux-2-turbo
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-2-turbo:
    post:
      tags:
        - text-to-image
      summary: Flux 2 Turbo - Create image from text
      description: >
        Create high-quality images quickly using FLUX.2 [turbo], the
        speed-optimized version of Flux 2.


        **Key Features:**

        - Fast generation (optimized for speed)

        - Lower cost than Pro version

        - Adjustable guidance scale for prompt adherence

        - Custom image dimensions (512-2048px)

        - Safety checker for content filtering

        - Multiple output formats (PNG/JPEG)


        **Use Cases:**

        - Rapid prototyping and iteration

        - Content exploration

        - High-volume generation

        - Testing prompts and concepts
      operationId: create_image_flux_2_turbo
      requestBody:
        content:
          application/json:
            examples:
              required-params:
                $ref: '#/components/examples/request-flux-2-turbo-required-params'
              all-params:
                $ref: '#/components/examples/request-flux-2-turbo-all-params'
            schema:
              $ref: '#/components/schemas/ttif2t-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-2-turbo-required-params:
      summary: Minimal request with required parameters only
      value:
        prompt: mountain landscape at golden hour with mist
    request-flux-2-turbo-all-params:
      summary: Complete request with all parameters
      value:
        prompt: >-
          portrait of a smiling person, natural lighting, soft focus background,
          professional photography
        guidance_scale: 3.5
        seed: 12345
        image_size:
          width: 1024
          height: 1024
        enable_safety_checker: true
        output_format: png
        webhook_url: https://your-app.com/webhooks/flux-2-turbo
  schemas:
    ttif2t-request-content:
      properties:
        prompt:
          description: >
            Text description of the image you want to generate.


            **FLUX.2 [turbo]** is optimized for speed while maintaining good
            quality. Perfect for rapid prototyping and testing.


            **Performance:**

            - Faster generation than Flux 2 Pro

            - Lower cost per generation

            - Great for iteration and experimentation


            **Tips:**

            - Works best with clear, descriptive prompts

            - Adjust guidance_scale for prompt adherence

            - Use seed for reproducibility


            **Examples:**

            - `"mountain landscape at golden hour"`

            - `"portrait of a smiling person, natural lighting, soft focus"`

            - `"abstract geometric pattern with vibrant colors"`
          example: a serene landscape with mountains and a lake at sunset
          type: string
        guidance_scale:
          default: 2.5
          description: >
            Controls how closely the model follows your prompt.


            **Range:** 1.0 to 20.0

            **Default:** 2.5


            **Guidelines:**

            - **Low (1-3):** More creative freedom, less literal interpretation

            - **Medium (3-7):** Balanced between creativity and prompt accuracy

            - **High (7-20):** Strict adherence to prompt, less creative
            variation


            **Recommendation:** Start with default (2.5) and adjust if needed.
          example: 2.5
          maximum: 20
          minimum: 1
          type: number
        seed:
          description: >
            Random seed for reproducible results.


            **Valid range:** 0 to 4,294,967,295

            **Default:** Random (if not provided)


            **Tip:** Save the seed from generations you like to create similar
            variations.
          example: 12345
          maximum: 4294967295
          minimum: 0
          nullable: true
          type: integer
        image_size:
          $ref: '#/components/schemas/ttif2t_request_content_image_size'
        enable_safety_checker:
          default: true
          description: >
            Enable content safety filtering.


            **When enabled:** Filters potentially unsafe content (NSFW,
            violence, etc.)

            **When disabled:** No content filtering (use responsibly and in
            compliance with terms)


            **Recommendation:** Keep enabled for production applications.
          example: true
          type: boolean
        output_format:
          default: png
          description: |
            Output image format.

            **PNG:**
            - Lossless compression
            - Supports transparency
            - Larger file size
            - Best for graphics and illustrations

            **JPEG:**
            - Lossy compression
            - Smaller file size
            - No transparency
            - Best for photos and realistic images
          enum:
            - jpeg
            - png
          example: png
          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:
        - 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
    ttif2t_request_content_image_size:
      description: |
        Custom image dimensions (alternative to using standard aspect ratios).

        **Valid range:** 512 to 2048 pixels for both width and height
        **Default:** 1024×1024 if not specified

        **Note:** Total resolution affects cost and generation time.
      nullable: true
      properties:
        width:
          description: Image width in pixels
          example: 1024
          maximum: 2048
          minimum: 512
          type: integer
        height:
          description: Image height in pixels
          example: 1024
          maximum: 2048
          minimum: 512
          type: integer
      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

````