截至 2026-10-19，公开 npm 包已发布，但尚未从 n8n 官方生产目录读到该包。不能把 npm 发布当作 Cloud 认证。本页使用 2026-10-19 正式 npm 新版，已包含服务名搜索别名和原生凭据帮助；npm 新版不自动更新 Cloud 认证版本。n8n 认证包要求英文文档，因此中文上手说明放在此独立客户页面。
安装并找到节点
- 自托管实例的 owner/admin 按 n8n 官方安装说明，进入 Settings → Community nodes → Install，填写
@acedatacloud/n8n-nodes-nano-banana@0.1.2。只在你信任并有权管理的实例中安装。 - Cloud 只走官方认证节点搜索安装；若搜不到，不改安全设置、不创建同名条目，也不宣称已安装。
- 在工作流先添加 Manual Trigger 或使用已有触发器，再从它后面的 + 搜索 Nano Banana，选择 Nano Banana by Ace Data Cloud；旧版显示 by AceDataCloud，内部节点 ID 保持不变。
此图是 n8n 官方教程原图，2026-10-18 引用，原始拍摄日期和版本未声明；图中为 HTTP Request 搜索布局，不是 Nano Banana 安装或执行结果。官方来源。
注册并准备专用 API Key
- 打开 Ace Data Cloud 应用管理，注册或登录。没有 General application（通用应用） 时先选择 Initialize General Application。
- 复制应用卡片上的 API Key，或进入 Keys / Manage Keys → Create 为 n8n 创建单独命名的密钥。通用应用使用账号已开通服务；专用应用只适用于对应服务。
- 检查 Expiration Time、Set Usage Limitation、Allowed APIs、Nano Banana 服务/模型权限、可用余额和当前价格。查询任务的权限不代表允许生成；试用额度以账号当前显示为准。
图片来自固定源码提交的真实平台界面（2026-10-18 引用）；不是 n8n 操作截图，也不证明当前账号有权限或余额。不要把任何真实密钥发到提示词、截图或共享工作流。
在 n8n 保存凭据
打开 Nano Banana 节点，在凭据栏创建 Nano Banana by Ace Data Cloud API（旧版显示 by AceDataCloud API）。将原始 Key 填入 API Token，不要加Bearer 、引号或空格。platform-... 账号管理 Token 不能用于生成或任务查询。
保存后在每个需要权限的节点上选择该凭据。当前凭据测试只查询空任务列表，不生成媒体；测试通过也不能保证某个模型或特定任务有访问权。Key 留在 n8n 凭据存储中，下载的示例不含凭据。
先查询自己的已有任务
- 下载仅查询已有任务的工作流，在 n8n 用 Import from URL/File 导入。它默认停用，仅含触发器、说明和 Nano Banana 查询节点；没有创建或模型节点。
- 将 Resource 设为 Task、Operation 设为 Get。在 Task ID 填入你有权读取、由同一服务返回的真实任务 ID，替换示例占位符。Task ID 不是提示词或媒体链接；不要用占位符执行。
- 选好凭据，只执行该查询节点一次。
finished=true且successful=true才表示成功终态，最终媒体链接在data。处理中继续查同一个 ID；失败/取消/权限错误按原结果处理。
首次创建与等待结果
已有查询流程确认后，另用 源仓的创建/轮询示例。选择 Resource → Image、Operation → Generate 和适用于该操作的模型；例如nano-banana 是现有示例值，运行前仍须核对当前权限和价格。
一次输入 item 可能创建一笔任务；不要批量输入后才检查预算。创建只运行一次，不开 Retry On Fail。保存返回的 taskId，每次间隔查询同 ID；设置明确超时和失败分支。收到 ID 只是提交成功，不是媒体完成。流程超时不会取消服务器任务，先查旧 ID 再决定是否重试，避免重复收费。
创建操作需要单独预算，本页没有替你提交收费请求。Credits 不是 USD，实际扣费以对应的单条用量记录为准，不以 Token 数量或示例时长推算。
常见问题
查看该服务源仓和支持入口 · 返回 n8n 接入总览。提交问题时带包版本、n8n版本、操作和脱敏错误，不附 API Key 或私人输入。