Nano Banana API — Nano工具

Name: Nano Banana API — Nano工具
Author: Nano Banana API

Nano Banana API

Nano Banana API — Nano工具

v0.1.1

Generate images through the Nano Banana 图像工具 REST API and help agents integrate or operate the service safely. Use when a task involves 文生图, image-to-im...

0· 138·1 当前·1 累计

by @sdhjkagbjksg (Nano Banana API)·MIT-0

API工具开发工具代码生成智能体

下载技能包

License

MIT-0

最后更新

2026/3/26

安全扫描

VirusTotal

Pending

查看报告

OpenClaw

安全

high confidence

The skill appears to do exactly what it says (wrap the Nano Banana image-generation REST API), requests only the expected API key and python3, and its included script and docs are consistent with that purpose.

评估建议

This skill is internally consistent for calling the Nano Banana image API, but review these practical considerations before installing: (1) The CLI will read NANO_BANANA_API_KEY or NB_API_KEY — keep that secret out of shared environments. (2) If you use --download-dir (or the agent follows the skill's download instructions), the skill will write files to disk; choose a safe directory and check for overwrites. (3) The script downloads images from URLs returned by the API — if you do not fully tru...

详细分析 ▾

✓ 用途与能力

Name/description, declared primaryEnv (NANO_BANANA_API_KEY), required binary (python3), included CLI script, and API reference all align with an image-generation API integration.

ℹ 指令范围

Instructions and the CLI are limited to listing models, checking credits, submitting sync/stream/async jobs, polling, and optionally downloading resulting images — consistent with the stated purpose. Callouts: the skill instructs agents to download generated images to a local directory (writes files to disk) and to follow image URLs returned by the API, which means the agent will make outbound requests to URLs supplied by the service.

✓ 安装机制

No install spec; this is instruction-only plus a bundled Python script. Nothing is downloaded or installed automatically by the skill itself.

✓ 凭证需求

Only the API key (NANO_BANANA_API_KEY / NB_API_KEY) and an optional base URL override are used. No unrelated credentials or broad environment access are requested.

✓ 持久化与权限

always is false, agent invocation is normal, and the skill does not request permanent platform presence or modify other skills/configs.

安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

查看条款 ↗

运行时依赖

无特殊依赖

版本

latestv0.1.12026/3/25

Add official website to skill docs and fix image downloads by sending an explicit User-Agent.

● Pending

安装命令点击复制

官方npx clawhub@latest install nano-banana-api

镜像加速npx clawhub@latest install nano-banana-api --registry https://cn.clawhub-mirror.com

技能文档

Use this skill when an agent needs to call Nano Banana directly instead of only editing docs.

Official website: https://www.nananobanana.com

Quick 开始

Set an API key with NANO_BANANA_API_KEY or NB_API_KEY.

Use the bundled CLI for repeatable calls:

python3 scripts/nano_banana_api.py models
python3 scripts/nano_banana_api.py credits
python3 scripts/nano_banana_api.py generate --prompt "A cinematic orange cat on a train" --mode sync
python3 scripts/nano_banana_api.py generate --prompt "Replace the background with a beach" --reference-image-url https://example.com/image.jpg --mode async --wait
python3 scripts/nano_banana_api.py generate --prompt "A cyberpunk skyline at night" --mode stream

Workflow

Call models 第一个当...时模型 name matters.
Omit --模型 unless 用户 explicitly asks 对于 specific 模型.
Choose 请求 mode 由 interaction pattern:

- 同步: simplest 请求/响应 flow. - stream: real-时间 progress 通过 SSE. - 异步: immediate submission 加上 later polling.

使用 poll --id --wait 当...时异步 task 必须 followed 到 completion.
下载 images 期间相同会话当...时用户 wants local files. 输出 URLs expire 之后 15 days.

Operational Rules

做不打印或 restate raw API 键.
Prefer models 在...上 hardcoding catalog values. live 模型列表 changes 和 source 的 truth.
如果 docs 和 live API behavior disagree, trust live endpoints 和 mention 日期的 verification.
Treat 401, 402, 403, 和 503 作为 actionable operational states:

- 401: 无效或 missing 键. - 402: insufficient credits. - 403: 账户做不有 API access 已启用. - 503: 异步队列 busy; 重试 later.

对于 stream, expect newline-delimited SSE data: events.
对于 异步, 仅 declare 成功之后 processingStatus becomes 已完成.

Command Guide

列表 models

python3 scripts/nano_banana_api.py models

Use this before selecting --model. Live verification on 2026-03-25 showed model names that differ from examples in the docs, so avoid assuming nano-banana is the current explicit model ID.

Check credits

python3 scripts/nano_banana_api.py credits

Generate synchronously

python3 scripts/nano_banana_api.py generate \
  --prompt "A watercolor mountain village at sunrise" \
  --mode sync \
  --download-dir ./outputs

Generate asynchronously 和 wait

python3 scripts/nano_banana_api.py generate \
  --prompt "A product hero shot of a banana-shaped lamp" \
  --mode async \
  --wait \
  --poll-interval 3 \
  --max-polls 60

关注 existing 任务

python3 scripts/nano_banana_api.py poll --id clxx123 --wait

Generate 从 reference image

python3 scripts/nano_banana_api.py generate \
  --prompt "Keep the subject, turn the room into a brutalist gallery" \
  --reference-image-url https://example.com/source.jpg \
  --mode sync

Fallback 没有 Script

If direct shell execution is unavailable, construct HTTP calls from references/api-reference.md. Use:

POST /generate 对于同步, stream, 或异步 submission.
获取 /generate?id=... 对于 polling.
获取 /models 到 resolve current 模型 names.
获取 /credits 到 inspect balance.

Resources

使用 references/api-reference.md 对于 endpoint shapes, 错误 handling, 和 live verification notes.
使用 scripts/nano_banana_api.py 对于 deterministic CLI access 没有第三个-party packages.

Use this skill when an agent needs to call Nano Banana directly instead of only editing docs.

Official website: https://www.nananobanana.com

Quick Start

Set an API key with NANO_BANANA_API_KEY or NB_API_KEY.

Use the bundled CLI for repeatable calls:

python3 scripts/nano_banana_api.py models
python3 scripts/nano_banana_api.py credits
python3 scripts/nano_banana_api.py generate --prompt "A cinematic orange cat on a train" --mode sync
python3 scripts/nano_banana_api.py generate --prompt "Replace the background with a beach" --reference-image-url https://example.com/image.jpg --mode async --wait
python3 scripts/nano_banana_api.py generate --prompt "A cyberpunk skyline at night" --mode stream

Workflow

Call models first when the model name matters.
Omit --model unless the user explicitly asks for a specific model.
Choose request mode by interaction pattern:

- sync: simplest request/response flow. - stream: real-time progress via SSE. - async: immediate submission plus later polling.

Use poll --id --wait when an async task must be followed to completion.
Download images during the same session when the user wants local files. Output URLs expire after 15 days.

Operational Rules

Do not print or restate the raw API key.
Prefer models over hardcoding catalog values. The live model list changes and is the source of truth.
If docs and live API behavior disagree, trust the live endpoints and mention the date of verification.
Treat 401, 402, 403, and 503 as actionable operational states:

- 401: invalid or missing key. - 402: insufficient credits. - 403: account does not have API access enabled. - 503: async queue is busy; retry later.

For stream, expect newline-delimited SSE data: events.
For async, only declare success after processingStatus becomes completed.

Command Guide

List models

python3 scripts/nano_banana_api.py models

Use this before selecting --model. Live verification on 2026-03-25 showed model names that differ from examples in the docs, so avoid assuming nano-banana is the current explicit model ID.

Check credits

python3 scripts/nano_banana_api.py credits

Generate synchronously

python3 scripts/nano_banana_api.py generate \
  --prompt "A watercolor mountain village at sunrise" \
  --mode sync \
  --download-dir ./outputs

Generate asynchronously and wait

python3 scripts/nano_banana_api.py generate \
  --prompt "A product hero shot of a banana-shaped lamp" \
  --mode async \
  --wait \
  --poll-interval 3 \
  --max-polls 60

Follow an existing job

python3 scripts/nano_banana_api.py poll --id clxx123 --wait

Generate from a reference image

python3 scripts/nano_banana_api.py generate \
  --prompt "Keep the subject, turn the room into a brutalist gallery" \
  --reference-image-url https://example.com/source.jpg \
  --mode sync

Fallback Without The Script

If direct shell execution is unavailable, construct HTTP calls from references/api-reference.md. Use:

POST /generate for sync, stream, or async submission.
GET /generate?id=... for polling.
GET /models to resolve current model names.
GET /credits to inspect balance.

Resources

Use references/api-reference.md for endpoint shapes, error handling, and live verification notes.
Use scripts/nano_banana_api.py for deterministic CLI access without third-party packages.

数据来源：ClawHub ↗ · 中文优化：龙虾技能库

OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务

License

运行时依赖

版本

安装命令 点击复制

技能文档

Quick 开始

Workflow

Operational Rules

Command Guide

列表 models

Check credits

Generate synchronously

Generate asynchronously 和 wait

关注 existing 任务

Generate 从 reference image

Fallback 没有 Script

Resources

Quick Start

Workflow

Operational Rules

Command Guide

List models

Check credits

Generate synchronously

Generate asynchronously and wait

Follow an existing job

Generate from a reference image

Fallback Without The Script

Resources

安装命令点击复制