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

Security Scan

The skill's requests, instructions, and included script line up with its stated purpose (text-to-image and image-editing via NanoPhoto.AI) and only require the single, expected API key.

Purpose & Capability

Name/description, API endpoints in docs, and the single required env var (NANOPHOTO_API_KEY) all align: the skill exists to call NanoPhoto.AI and it requests exactly the credential needed to do that.

Instruction Scope

SKILL.md and the bundled Python script instruct only to submit generation/edit requests and poll the NanoPhoto API. They do not read unrelated files, other environment variables, or send data to third-party endpoints beyond the documented nanophoto.ai URLs.

Install Mechanism

No install spec; the skill is instruction-only with a bundled Python script. Nothing is downloaded from external arbitrary URLs and no archive extraction is used.

Credentials

Only NANOPHOTO_API_KEY is required (declared as primaryEnv). The script accepts an explicit --api-key override; no other credentials or sensitive env vars are requested.

Persistence & Privilege

always is false, the skill is user-invocable, and it does not attempt to modify other skills or global agent configuration. It does not request elevated or persistent privileges.

Assessment

This skill appears coherent: it only needs your NanoPhoto API key and uses the service's documented endpoints. Before installing, ensure the NANOPHOTO_API_KEY you provide is the correct key and that you trust nanophoto.ai. Do not paste the key into chat; set it in the skill's secure env setting. Review the bundled Python script if you can—it prints API responses to stdout and polls the official nanophoto.ai endpoints. Be mindful of costs and rate limits (the docs mention credits per quality level) and only supply public image URLs you are authorized to share. If you need stronger assurance, verify the publisher/provenance (owner ID is opaque here) or run the script in an isolated environment/network monitor to confirm it only communicates with the documented nanophoto.ai endpoints.

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:

{
  "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:

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:

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:

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):

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):

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

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

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.