Nanobanana Plus

MCP Tools

Use nanobanana-plus CLI to generate images with per-call model switching and aspect ratio control. Direct CLI invocation - no server required. Supports: node nanobanana-plus.mjs generate --prompt 'desc' --filename 'out.png' [--aspect-ratio 16:9] [--model gemini-3.1-flash-image-preview]. Also supports check and models.

Install

openclaw skills install nanobanana-plus

nanobanana-plus for OpenClaw

Direct CLI invocation - no HTTP server required.

Quick Start

# Set your API key (once)
export NANOBANANA_GEMINI_API_KEY="your_key_here"

# Generate an image
node nanobanana-plus.mjs generate --prompt "a cute cat" --filename cat.png

Commands

Generate Image

node nanobanana-plus.mjs generate \
  --prompt "一只橘猫坐在雨天窗台上" \
  --filename "cat-window.png" \
  --aspect-ratio "16:9"

Options:

FlagDescription
--promptImage description (required)
--filenameOutput file path
--aspect-ratio16:9, 9:16, 1:1, 4:3, 3:4, 21:9
--modelModel name (see below)
--output-countNumber of images (1-8)

List Available Models

node nanobanana-plus.mjs models

Health Check

node nanobanana-plus.mjs check

Models

ModelDescription
gemini-3.1-flash-image-previewNano Banana 2 (default) - fast, quota-efficient
gemini-3-pro-image-previewNano Banana Pro - higher quality
imagen-4.0-ultra-generate-001Imagen 4 Ultra - best realism (requires Pro key)
imagen-4.0-fast-generate-001Imagen 4 Fast - balanced speed/quality (requires Pro key)

Example with specific model:

node nanobanana-plus.mjs generate \
  --prompt "majestic snowy mountain, photorealistic" \
  --filename mountain.png \
  --model "gemini-3-pro-image-preview" \
  --aspect-ratio "16:9"

Environment

The CLI uses these environment variables (set once in your shell):

export NANOBANANA_GEMINI_API_KEY="your_key"  # Recommended
# or
export GEMINI_API_KEY="your_key"  # Fallback

Notes

  • No server needed - CLI generates images directly
  • edit and restore are not supported in CLI mode (use MCP server for these features)
  • Image files are saved locally and printed with MEDIA: prefix for chat providers