Get API Key Get API
Docs

Nano banana Image Generation

- Asynchronous processing mode, returns task ID for subsequent queries

  • Fast generation speed, optimized for quick 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-ext, which is equivalent to gemini-2.5-flash-image-preview. The two are interchangeable and produce identical results.

Request example

# model can be "gemini-2.5-flash-image-preview", or the compatible alias "nano-banana-ext"
curl --request POST \
  --url https://api.openveer.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-2.5-flash-image-preview",
    "prompt": "A bamboo forest path under moonlight",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://openai-documentation.vercel.app/images/cat_and_otter.png"
    ]
  }'

Response example

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

Authorizations

Authorization string

All API endpoints require Bearer Token authentication

Get your API Key:

Visit the API Key Management Page to get your API Key

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Body

model string

Image generation model name

Supported models:

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

Example: "gemini-2.5-flash-image-preview" or "gemini-2.5-flash-image-preview-official"

Note



For backward compatibility, the aliases nano-banana-ext (for gemini-2.5-flash-image-preview) and nano-banana (for gemini-2.5-flash-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

Maximum 1000 characters

size string

Image generation size

Supported formats:

  • Ratio: 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.

resolution string

Output image resolution

Supported values:

  • 1K - 1K resolution (default)
n integer

Number of images to generate

Range: 1

Default: 1

⚠️ Note: Must enter a plain number (e.g., 1), do not use quotes or it will cause an error

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-2.5-flash-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 10MB
    • 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.