nano-banana-image

Ace Data Cloud 的 Nano Banana

通过 AceDataCloud 的 NanoBanana（基于 Gemini）API 生成和编辑 AI 图像。

从 skills.sh 安装并连接

此集成由 Ace Data Cloud 维护；它不是 Nano Banana 官方发布者的条目。只安装此 Skill：npx skills add acedatacloud/skills --skill nano-banana-image --yes，或使用 skills.sh 公共页面。选择时请保留 slug nano-banana-image。

请阅读图文并茂的首次运行指南（简体中文，了解注册、Applications → General application、API 密钥获取和价格查询，以及编码 Agent 的环境变量位置。通过 skills.sh 安装时，请使用本指南；任何特定于 ClawHub 的设置仅适用于 OpenClaw。此处链接的共享参考资料在线提供，因为精简安装不包含同级的 _shared/ 文件夹。

ClawHub / OpenClaw 设置

1. 使用 clawhub install @acedatacloud/nano-banana 安装官方 Skill。请确认 ClawHub 发布者是 @acedatacloud。
2. 登录 AceDataCloud → Applications，打开 General application，并检查 Nano Banana 的访问权限、余额和当前价格。复制其 API 密钥，或选择 Manage Keys → Create 创建单独的密钥。复制密钥值时不要包含 Bearer ；platform-... 管理令牌不是服务 API 密钥。
3. 如果启用 Allowed APIs 限制，请加入 /nano-banana/images 和 /nano-banana/tasks。下文的高级工作流可能会调用其他路由。
4. 在 OpenClaw Gateway 主机上，将 ACEDATACLOUD_API_TOKEN=your_api_key_here 放入 ~/.openclaw/.env，然后重启 Gateway 并开始新会话。若要直接在终端测试，请在该 shell 中运行 export ACEDATACLOUD_API_TOKEN="your_api_key_here"。切勿将密钥放入提示词或提交 .env 文件。
5. 运行下方的 快速开始。如果此工作流返回任务 ID，请查询同一任务直至完成；不要仅为了查看进度而再次提交相同的计费请求。

密钥设置、首次运行和故障排除图文指南 · 令牌详情

快速开始

curl -X POST https://api.acedata.cloud/nano-banana/images \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "a watercolor painting of a French countryside village", "model": "nano-banana"}'

**异步：**请参阅异步任务轮询。通过 POST /nano-banana/tasks 发送 {"id": "..."} 进行轮询。

模型

模型	最适合用途
nano-banana	标准图像生成（默认）
nano-banana-2-lite	快速、轻量的第二代模型
nano-banana-2	质量更高的第二代模型
nano-banana-2.1	最新的高效模型；支持生成和编辑 1K、2K 与 4K 图像
nano-banana-pro	质量最高、细节最丰富的输出
nano-banana:official	nano-banana 的官方渠道变体
nano-banana-2-lite:official	nano-banana-2-lite 的官方渠道变体
nano-banana-2:official	nano-banana-2 的官方渠道变体
nano-banana-pro:official	nano-banana-pro 的官方渠道变体

工作流

1. 文本生成图像

POST /nano-banana/images
{
  "action": "generate",
  "prompt": "a photorealistic macro shot of morning dew on a spider web",
  "model": "nano-banana-2.1",
  "aspect_ratio": "16:9",
  "resolution": "2K"
}

2. 图像编辑

使用自然语言指令编辑现有图像，无需掩码。通过 image_urls 传入源图像。

POST /nano-banana/images
{
  "action": "edit",
  "prompt": "change the background to a starry night sky",
  "image_urls": ["https://example.com/photo.jpg"],
  "model": "nano-banana-2.1",
  "resolution": "2K"
}

参数

参数	值	描述
action	"generate", "edit"	操作模式
model	"nano-banana", "nano-banana-2-lite", "nano-banana-2", "nano-banana-2.1", "nano-banana-pro", "nano-banana:official", "nano-banana-2-lite:official", "nano-banana-2:official", "nano-banana-pro:official"	要使用的模型；2.1 没有 :official 变体
prompt	string	图像描述或编辑指令
image_urls	array of strings	源图像 URL（编辑操作必需）
aspect_ratio	"1:1", "3:2", "2:3", "16:9", "9:16", "4:3", "3:4"	输出宽高比
resolution	"1K", "2K", "4K"	默认值为 1K；nano-banana 和 nano-banana-2-lite 仅支持 1K；2、2.1 和 Pro 支持全部三种分辨率
callback_url	string	异步回调 URL；立即返回任务 ID

要使用 2.1，请明确设置 model:"nano-banana-2.1"；省略 model 仍会选择 nano-banana。对于非阻塞请求，请设置 async:true，保留 task_id，并轮询 /nano-banana/tasks，直到任务成功结束后再返回图像。尚未发布 nano-banana-2.1:official 变体。

POST /openai/images/generations（公开别名 /v1/images/generations）和 POST /openai/images/edits（公开别名 /v1/images/edits）也接受同一 2.1 模型。这些接口使用各自兼容 OpenAI 的 schema（JSON 编辑使用 image，而非 image_urls；使用 size，而非此接口的 resolution/aspect_ratio）。重新使用请求前，请检查该接口当前的 schema；不要假设响应字段相同。价格取决于当前服务/套餐；请查询实时价格，不要硬编码每次调用的美元金额。

注意事项

• 编辑不需要遮罩——只需用自然语言描述要做的更改
• 编辑使用相同的 /nano-banana/images 接口，设置 action: "edit" 并提供 image_urls 数组（而非单独的 /edit 路径）
• nano-banana-2.1 支持 1K、2K 和 4K；nano-banana-pro 提供最高画质
• :official 变体（例如 nano-banana:official）通过官方渠道路由
• 任务轮询在 /nano-banana/tasks 请求正文中使用 id（而非 task_id）
• 宽高比使用冒号表示法（例如 "16:9"），而非像素尺寸
• 基于 Gemini 的模型擅长理解复杂的对话式编辑指令

MCP： pip install mcp-nano-banana | 托管服务：https://nanobanana.mcp.acedata.cloud/mcp | 查看所有 MCP 服务