Get API Key Get API
Docs

Nano banana Pro Image Generation

- Asynchronous processing mode, returns task ID for subsequent queries

  • High-quality image generation, professional-grade image creation
  • Generated image links are valid for 24 hours, please save them promptly
Info

Model name compatibility note: This endpoint also accepts the alias nano-banana-pro-ext, which is equivalent to gemini-3-pro-image-preview. The two are interchangeable and produce identical results.

Request example

# model can be "gemini-3-pro-image-preview", or the compatible alias "nano-banana-pro-ext"
curl --request POST \
  --url https://api.openveer.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "A bamboo forest path under moonlight",
    "size": "1:1",
    "n": 1,
    "resolution": "1K"
  }'

Response example

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Authorizations

Authorization string

All APIs require authentication using Bearer Token

Get API Key:

Visit API Key Management Page to obtain your API Key

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

model string

Image generation model name

Supported models:

  • gemini-3-pro-image-preview - Standard version (compatible alias nano-banana-pro-ext)
  • gemini-3-pro-image-preview-official - Official version (compatible alias nano-banana-pro)

Example: "gemini-3-pro-image-preview" or "gemini-3-pro-image-preview-official"

Note



For backward compatibility, the aliases nano-banana-pro-ext (for gemini-3-pro-image-preview) and nano-banana-pro (for gemini-3-pro-image-preview-official) remain usable.

nsfw_check boolean

Whether to run content moderation before submitting the image task.

  • true: use omni-moderation-latest to review prompts and input images
  • false or omitted: do not send a moderation request, adding no moderation cost or latency (default)
prompt string

Text description for image generation

size string

Image generation size

Supported formats:

  • Ratios: auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9

Warning



For text-to-image, when size is auto, the default is 1:1 or 16:9; for image-to-image, the aspect ratio follows the upstream response. We recommend specifying an aspect ratio.

n integer

Number of images to generate

Range: 1

Default: 1

⚠️ Note: Must be a pure number (e.g. 1), do not add quotes, otherwise it will error

resolution string

Output image resolution

Supported values:

  • 1K - 1K resolution (default)
  • 2K - 2K resolution
  • 4K - 4K resolution

⚠️ Note: Generating 4K images with base64 format takes longer processing time

official_fallback boolean

Whether to use the official channel fallback

  • false: Do not use (default)
  • true: Use official channel

Warning



When using the official channel (gemini-3-pro-image-preview-official), this parameter cannot be used.

image_urls array

List of reference image URLs for image-to-image or image editing

💡 Quick Fill (Try it area):

  1. Click "+ Add an item" to add an image URL
  2. Enter the complete image URL address or base64 data

    Each element in the array is a string, supporting two formats:

    1. Complete image URL address

    • Publicly accessible image URL (http\:// or https\://)
    • Example: "https://example.com/image.jpg"

    2. Base64 encoded format

    • Must use complete Data URI format
    • Format: data:image/{format};base64,{base64data}
    • Supported image formats: jpeg, png, webp, etc.
    • Example: "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg..."
    • ⚠️ Note: Must include the data:image/jpeg;base64, prefix

    Limitations:

    • Single image must not exceed 30MB
    • Supported formats: .jpeg, .jpg, .png, .webp

Limit: Maximum 14 images

Response

code integer

Response status code

data array
Response data array
status string

Task status

  * submitted - Submitted
task_id string

Unique task identifier

This documentation is built and hosted on Mintlify, a developer documentation platform.