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

# Create Image

> Generate images from text descriptions using Google's Nano Banana Pro Flash model (Gemini 3.1 Flash), a faster variant of Nano Banana Pro optimized for quick image generation.

**Key Features:**
- Fast image generation with Gemini 3.1 Flash
- Google Search grounding for real-world accuracy
- Support for reference images for guided generation
- Multiple aspect ratios and resolutions up to 4K

**Best for:**
- Rapid image generation with shorter wait times
- Grounded image generation using Google Search
- Reference-guided generation
- Iterative creative workflows where speed matters




## OpenAPI

````yaml POST /v1/ai/text-to-image/nano-banana-pro-flash
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/nano-banana-pro-flash:
    post:
      tags:
        - text-to-image
      summary: Create image from text - Nano Banana Pro Flash
      description: >
        Generate images from text descriptions using Google's Nano Banana Pro
        Flash model (Gemini 3.1 Flash), a faster variant of Nano Banana Pro
        optimized for quick image generation.


        **Key Features:**

        - Fast image generation with Gemini 3.1 Flash

        - Google Search grounding for real-world accuracy

        - Support for reference images for guided generation

        - Multiple aspect ratios and resolutions up to 4K


        **Best for:**

        - Rapid image generation with shorter wait times

        - Grounded image generation using Google Search

        - Reference-guided generation

        - Iterative creative workflows where speed matters
      operationId: create_image_from_text_nano_banana_pro_flash
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/tti-nano-banana-pro-flash-request'
        required: true
      responses:
        '200':
          content:
            application/json:
              examples:
                success - in progress task:
                  $ref: '#/components/examples/200-task-in-progress'
              schema:
                $ref: >-
                  #/components/schemas/get_style_transfer_task_status_200_response
          description: >-
            OK - The request has succeeded and the Nano Banana Pro Flash process
            has started.
        '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: Your request parameters didn't validate.
                    invalid_params:
                      - name: page
                        reason: Parameter 'page' must be greater than 0
                      - name: 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:
  schemas:
    tti-nano-banana-pro-flash-request:
      properties:
        prompt:
          description: >
            Text prompt describing the image you want to generate.


            **Tips:**

            - Be specific about visual details, composition, and style

            - Nano Banana Pro Flash is optimized for speed while maintaining
            quality

            - Enable Google Search grounding for images that need real-world
            accuracy


            **Examples:**

            - Simple: "A suited raccoon smoking a pipe"

            - Detailed: "A suited raccoon smoking a pipe in a vintage study
            room, warm lighting, leather armchair, bookshelves in background"
          example: A suited raccoon smoking a pipe in a vintage study room
          maxLength: 3000
          minLength: 2
          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
        reference_images:
          description: |
            Optional reference images for guided generation.
            Each image can include associated text and mime type.

            **Image requirements:**
            - Maximum 14 images
            - Supported formats: PNG, JPEG, WebP
            - Publicly accessible URLs or GCS format
          example:
            - image: https://example.com/reference.jpg
              text: Reference style
              mime_type: image/jpeg
          items:
            $ref: >-
              #/components/schemas/tti_nano_banana_pro_request_reference_images_inner
          maxItems: 14
          type: array
        aspect_ratio:
          default: '1:1'
          description: |
            Aspect ratio for the generated image.

            **Available ratios:**
            - `1:1`: Square (default)
            - `2:3`, `3:2`: Portrait/Landscape
            - `4:3`, `3:4`: Standard
            - `5:4`, `4:5`: Photo print
            - `16:9`, `9:16`: Widescreen/Social stories
            - `21:9`: Ultra-wide cinematic
          enum:
            - '1:1'
            - '2:3'
            - '3:2'
            - '4:3'
            - '3:4'
            - '5:4'
            - '4:5'
            - '16:9'
            - '9:16'
            - '21:9'
          example: '1:1'
          type: string
        resolution:
          default: 1K
          description: |
            Resolution quality for the generated image.

            **Available resolutions:**
            - `1K`: Lower resolution, faster generation (default)
            - `2K`: Standard resolution, balanced quality/speed
            - `4K`: High resolution, best quality
          enum:
            - 1K
            - 2K
            - 4K
            - low
            - medium
            - high
          example: 1K
          type: string
        use_google_search_tool:
          default: false
          description: >
            Enable Google Search grounding during image generation.

            When enabled, the model uses Google Search to ground its output with
            real-world information,

            improving accuracy for prompts that reference real places, people,
            brands, or current events.


            **Note:** When enabled, the task response may include grounding
            metadata with source information.
          type: boolean
      required:
        - prompt
      title: Nano Banana Pro Flash Text-to-Image Request
      type: object
    get_style_transfer_task_status_200_response:
      example:
        data:
          task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          status: CREATED
          generated:
            - https://openapi-generator.tech
            - https://openapi-generator.tech
      properties:
        data:
          $ref: '#/components/schemas/task-detail'
      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
    tti_nano_banana_pro_request_reference_images_inner:
      properties:
        image:
          description: Image URL (publicly accessible URL or GCS format)
          example: https://example.com/reference-image.jpg
          type: string
        text:
          description: Optional text description to attach to the reference image
          example: Reference style for lighting and composition
          type: string
        mime_type:
          description: MIME type of the image
          enum:
            - image/png
            - image/jpeg
            - image/webp
          example: image/jpeg
          type: string
      required:
        - image
        - mime_type
      type: object
    task-detail:
      allOf:
        - $ref: '#/components/schemas/task'
        - properties:
            generated:
              items:
                description: URL of the generated image
                format: uri
                type: string
              type: array
          required:
            - generated
          type: object
      example:
        task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        status: CREATED
        generated:
          - https://openapi-generator.tech
          - https://openapi-generator.tech
    get_all_style_transfer_tasks_400_response_1_problem:
      properties:
        message:
          example: Your request parameters didn't validate.
          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
    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_invalid_params_inner:
      properties:
        name:
          example: page
          type: string
        reason:
          example: Parameter 'page' must be greater than 0
          type: string
      required:
        - name
        - reason
      type: object
  examples:
    200-task-in-progress:
      summary: Success - Task in progress
      value:
        data:
          generated: []
          task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          status: IN_PROGRESS
  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

````