Nano Banana Pro

Generate or edit AI images with the NanoPhoto.AI Nano Banana Pro API. Use when: (1) User wants text-to-image generation from a prompt, (2) User wants image-to-image editing from one or more public image URLs, (3) User mentions Nano Banana Pro, NanoPhoto image generation, text to image, image to image, image editing, generationId lookup, prompt-based image creation, or checking generation status. Supports automatic polling until completion and resuming an existing generationId. Prerequisite: Obtain an API key at https://nanophoto.ai/settings/apikeys and configure env.NANOPHOTO_API_KEY.

Generate or edit images through the NanoPhoto.AI Nano Banana Pro API.

Prerequisites

1. Obtain an API key at: https://nanophoto.ai/settings/apikeys
2. Configure NANOPHOTO_API_KEY before using the skill.

Preferred OpenClaw setup:

• Open the skill settings for this skill
• Add an environment variable named NANOPHOTO_API_KEY
• Paste the API key as its value

Equivalent config shape:

json

{
  "skills": {
    "entries": {
      "nano-banana-pro": {
        "enabled": true,
        "env": {
          "NANOPHOTO_API_KEY": "your_api_key_here"
        }
      }
    }
  }
}

Other valid ways to provide the key:

• Shell: export NANOPHOTO_API_KEY="your_api_key_here"
• Tool-specific env config: any runtime that injects NANOPHOTO_API_KEY

Choose the mode

• Use generate for text-to-image.
• Use edit for image-to-image edits.
• For edit, provide one or more public image URLs.
• Do not use local image files or base64 images with the API. The API only accepts inputImageUrls.

Recommended workflow

1. Collect the prompt.
2. Decide mode: generate or edit.
3. Choose aspectRatio and imageQuality.
4. For edit, collect up to 8 public image URLs.
5. Submit the generation request.
6. Poll the status endpoint every 5 seconds until completed or failed.
7. Return the final imageUrl and progress/result details.
8. Expect real-world wait time to vary from roughly 30 seconds to 300 seconds depending on queue/load and prompt complexity; avoid short timeouts.

Preferred command

Use the bundled script for reliable submission + polling:

Text to image

macOS / Linux:

bash

python3 scripts/nano_banana_generate.py \
  --prompt "A futuristic cityscape at sunset with flying cars and neon lights" \
  --mode generate \
  --aspect-ratio 16:9 \
  --image-quality 2K

Windows:

bash

python scripts/nano_banana_generate.py ^
  --prompt "A futuristic cityscape at sunset with flying cars and neon lights" ^
  --mode generate ^
  --aspect-ratio 16:9 ^
  --image-quality 2K

Image to image

macOS / Linux:

bash

python3 scripts/nano_banana_generate.py \
  --prompt "Transform this photo into a watercolor painting style" \
  --mode edit \
  --input-image-url https://static.nanophoto.ai/demo/nano-banana-pro.webp \
  --aspect-ratio 16:9 \
  --image-quality 1K

Windows (cmd.exe):

bash

python scripts/nano_banana_generate.py ^
  --prompt "Transform this photo into a watercolor painting style" ^
  --mode edit ^
  --input-image-url https://static.nanophoto.ai/demo/nano-banana-pro.webp ^
  --aspect-ratio 16:9 ^
  --image-quality 1K

Windows (PowerShell):

powershell

python scripts/nano_banana_generate.py `
  --prompt "Transform this photo into a watercolor painting style" `
  --mode edit `
  --input-image-url https://static.nanophoto.ai/demo/nano-banana-pro.webp `
  --aspect-ratio 16:9 `
  --image-quality 1K

The script reads NANOPHOTO_API_KEY from the environment, submits the task, polls automatically, and prints the final JSON result.

Manual API calls

Submit generation

bash

curl -X POST "https://nanophoto.ai/api/nano-banana-pro/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $NANOPHOTO_API_KEY" \
  --data-raw '{
    "prompt": "A futuristic cityscape at sunset with flying cars and neon lights",
    "mode": "generate",
    "aspectRatio": "16:9",
    "imageQuality": "2K"
  }'

Check status

bash

curl -X POST "https://nanophoto.ai/api/nano-banana-pro/check-status" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $NANOPHOTO_API_KEY" \
  --data-raw '{"generationId": "abc123xyz"}'

Parameter guidance

• aspectRatio
  • 16:9
  • 9:16
  • 4:3
  • 3:4
• imageQuality
  • 1K: lowest cost
  • 2K: balanced quality/cost
  • 4K: highest cost
• inputImageUrls
  • Max 8 URLs
  • Must be publicly reachable

Error handling

errorCode	Cause	Action
LOGIN_REQUIRED	Invalid or missing API key	Verify key at https://nanophoto.ai/settings/apikeys
API_KEY_RATE_LIMIT_EXCEEDED	Rate limit exceeded	Wait and retry
INSUFFICIENT_CREDITS	Not enough credits	Top up credits
INVALID_PROMPT	Missing or empty prompt	Ask user for a prompt
MISSING_INPUT_IMAGE	Edit mode missing images	Ask for public image URLs
TOO_MANY_IMAGES	More than 8 images	Reduce to 8 or fewer URLs
IMAGE_URLS_REQUIRED	API needs inputImageUrls	Do not send base64 or local file paths
NOT_FOUND	Invalid generation ID	Re-submit or verify the ID
FORBIDDEN	Task not owned by this key	Verify account/key ownership
GENERATION_FAILED	Server-side failure	Retry or simplify the prompt

Bundled files

• scripts/nano_banana_generate.py: submit a generation/edit task and poll until completion.
• references/api.md: condensed API reference, costs, and response shapes. erate.py`: submit a generation/edit task and poll until completion.
• references/api.md: condensed API reference, costs, and response shapes. eference, costs, and response shapes.