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

# Generate Image (Pro)

> Submit NanoBanana Pro image generation task using the nano-banana-pro model.

### Important Notes

* Task ID returned in response is used to query task status via the Get Task Details endpoint
* Callback URL notifications are sent immediately upon task completion


## OpenAPI

````yaml nanobanana-api/nanobanana-api.json post /api/v1/nanobanana/generate-pro
openapi: 3.0.0
info:
  title: NanoBanana API
  description: NanoBanana API Documentation - Image Generation and Editing API
  version: 1.0.0
  contact:
    name: Technical Support
    email: support@nanobananaapi.ai
servers:
  - url: https://api.nanobananaapi.ai
    description: API Server
security:
  - BearerAuth: []
paths:
  /api/v1/nanobanana/generate-pro:
    post:
      summary: Generate Image (Pro)
      description: >-
        Submit NanoBanana Pro image generation task using the nano-banana-pro
        model.


        ### Model Information

        The nano-banana-pro model supports:

        - High-quality text-to-image generation

        - Image-to-image transformation

        - Multiple aspect ratios and resolutions

        - Batch image processing (up to 10 input images)
      operationId: generate-image-pro
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                  description: A text description of the image you want to generate
                  example: A cute cat is eating.
                imageUrls:
                  type: array
                  items:
                    type: string
                    format: uri
                  maxItems: 8
                  description: >-
                    Input images to transform or use as reference (supports up
                    to 8 images)
                  example:
                    - https://example-image.png
                resolution:
                  type: string
                  enum:
                    - 1K
                    - 2K
                    - 4K
                  description: Resolution of the generated image
                  example: 2K
                callBackUrl:
                  type: string
                  format: uri
                  description: >-
                    Callback URL to receive task completion notifications
                    (required)
                  example: https://example-callback.com
                aspectRatio:
                  type: string
                  enum:
                    - '1:1'
                    - '2:3'
                    - '3:2'
                    - '3:4'
                    - '4:3'
                    - '4:5'
                    - '5:4'
                    - '9:16'
                    - '16:9'
                    - '21:9'
                    - auto
                  description: Aspect ratio of the generated image
                  example: '16:9'
              required:
                - prompt
              example:
                prompt: A cute cat is eating.
                imageUrls:
                  - ''
                resolution: 2K
                callBackUrl: https://example-callback.com
                aspectRatio: '16:9'
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    description: Response status code
                    example: 200
                  message:
                    type: string
                    description: Response message
                    example: success
                  data:
                    type: object
                    properties:
                      taskId:
                        type: string
                        description: Task ID for querying task status
                        example: task_12345678
              example:
                code: 200
                message: success
                data:
                  taskId: task_12345678
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        All APIs require authentication via Bearer Token.


        Get API Key:

        1. Visit [API Key Management Page](https://nanobananaapi.ai/api-key) to
        get your API Key


        Usage:

        Add to request header:

        Authorization: Bearer YOUR_API_KEY


        Note:

        - Keep your API Key secure and do not share it with others

        - If you suspect your API Key has been compromised, reset it immediately
        in the management page

````