Nanobanana 2 Lite 图像生成
Nanobanana 2 Lite 图像生成在此以 EvoLink API 端点的形式公开,并附带一个可安装的 Agent 技能。
何时激活此技能
当用户要求执行以下操作时,激活此技能:
- 使用 Nanobanana 2 Lite 图像生成
- 通过 EvoLink 运行 Nanobanana 2 Lite 图像生成
- 生成模型输出
- 测试 API 流程
关键词:nanobanana-2-lite-image-generation, evolink, api, agent, skill
脚本位置
重要:此文件中所有脚本路径均相对于包含此 SKILL.md 文件的目录。在运行任何脚本之前,请先解析出绝对路径:
SKILL_DIR = 包含此 SKILL.md 文件的目录
Script = {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh
例如,如果此 SKILL.md 位于 ~/.claude/skills/nanobanana-2-lite-image/SKILL.md,则脚本位于 ~/.claude/skills/nanobanana-2-lite-image/scripts/nanobanana-2-lite-image.sh。
安装后
当此技能首次加载时,主动问候用户并启动设置流程:
-
检查是否设置了
EVOLINK_API_KEY(运行:echo $EVOLINK_API_KEY)- 如果未设置: “要运行模型,您需要一个 EvoLink API 密钥。请打开 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image,创建一个密钥,然后将其粘贴到这里,我将为本次会话设置它。”
- 如果已设置: “一切就绪!您想用 Nanobanana 2 Lite 图像生成做什么?”
-
就这样。只问一个问题。用户现在进入流程。
不要列出功能、显示菜单或倾倒说明。只需问一个问题以推进。
核心原则
- 引导而非决定 — 提供选项,让用户决定。不要对他们的偏好做假设。
- 让用户主导 — 如果他们有想法,使用他们的措辞。如果他们需要灵感,提供建议并让他们选择或细化。
- 智能上下文感知 — 识别用户已经提供的信息,只询问缺失的部分。
- 意图优先 — 如果用户意图不明确,先确认他们想要什么,然后再继续。
流程
步骤 1:检查 API 密钥
如果用户尚未提供 API 密钥或未设置 EVOLINK_API_KEY:
- 告知他们需要一个 EvoLink API 密钥
- 引导他们打开 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 并从仪表板获取密钥
- 一旦他们提供了密钥,进入步骤 2
如果密钥已设置或已提供,直接跳到步骤 2。
步骤 2:理解意图
根据用户的消息评估他们想要什么:
- 意图明确(例如,“用一个简短的提示词运行 Nanobanana 2 Lite 图像生成”) -> 进入步骤 3
- 意图模糊(例如,“我想试试”) -> 询问他们想做什么。
步骤 3:收集缺失信息
检查用户已提供的内容,仅询问缺失的部分:
| 参数 | 告知用户什么 | 是否必需 |
|---|---|---|
| 待定 | 待定 | 是 |
| 待定 | 待定 | 是 |
| 待定 | 待定 | 可选 |
| 待定 | 待定 | 可选 |
智能收集规则 — 严格:
- 在一次消息中询问所有缺失的参数。 绝不要分成多轮提问。
- 永远不要重复提问。 如果用户已经回答了某个参数,那就是最终答案——不要再次询问。
- 预先提供默认值,以便用户可以说“默认即可”:
model=gemini-3.1-flash-lite-image, prompt='创建一个简短的演示'。如果用户说“默认”或“直接开始”,立即使用这些值。 - 用户一次性给出所有信息 -> 确认并立即运行模型,不再提问。
- 用户给出部分信息 -> 仅询问剩余的必需字段,全部放在一条消息中。
- 可选参数都有合理的默认值——如果用户跳过它们,使用默认值并继续。
步骤 4:执行
一旦所有必需信息确认:
- 在运行脚本之前,立即告知用户:“收到!我将通过 EvoLink 运行 Nanobanana 2 Lite 图像生成。”
- 只运行一次脚本。除非用户明确要求重试,否则绝不要再次运行。
- 完成后,分享结果和耗时。
各代理的执行模式
Claude Code — 使用 Bash 工具,设置 run_in_background: true,然后读取输出文件以检查进度:
# 步骤 1:在后台运行(首先解析 SKILL_DIR)
Bash(command: "{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh \"input\" --dry-run true", run_in_background: true, timeout: 300000)
# 步骤 2:等待约 30 秒,然后读取后台任务的输出文件,查找 RESULT_URL= 或 STATUS_UPDATE 行
# 步骤 3:当看到 RESULT_URL=<value> 时,将其传递给用户
OpenClaw / OpenCode / Cursor — 以阻塞式 shell 命令运行脚本(脚本内部处理轮询,通常 2-10 分钟完成):
EVOLINK_API_KEY=$EVOLINK_API_KEY {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "input" --dry-run true
所有代理 — 关键规则:
- 一旦在输出中看到
TASK_SUBMITTED:,任务已在服务器上排队。不要再运行脚本——重试会浪费用户的 API 配额。 - 脚本会阻塞直到任务就绪(最长 5 分钟)。不要过早终止它。
- 如果脚本超时并显示
POLL_TIMEOUT,任务可能仍在处理——告知用户检查 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image。
脚本用法
记住:将 {SKILL_DIR} 替换为包含此 SKILL.md 文件的实际目录。
# 设置 API 密钥
export EVOLINK_API_KEY=your_key_here
# 基本用法
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "创建一个简短的 Nanobanana 2 Lite 图像生成演示"
# 带选项
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "测试提示词" --dry-run true --timeout TBD
# 高级用法
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "空运行" --help TBD
# 空运行(预览负载,不调用 API)
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "测试" --dry-run
脚本输出协议
脚本将结构化行写入标准输出,您必须解析并据此操作:
| 行格式 | 出现时机 | 您的操作 |
|---|---|---|
TASK_SUBMITTED: task_id=<id> estimated=<Ns> | 提交后立即 | 向用户确认任务已启动。 这意味着 API 调用成功——不要重试。 |
STATUS_UPDATE: <message> | 每 ~15 秒执行期间 | 传递给用户——例如,“仍在处理中,大约还剩 30 秒...” |
RESULT_URL=<value> | 成功时 | 提取并向用户展示 |
ELAPSED=<Ns> | 成功时 | 可选地提及耗时 |
POLL_TIMEOUT: task_id=<id> dashboard=<url> | 轮询超过 5 分钟 | 告知用户:“您的任务可能已经完成——请检查 <dashboard_url>(任务:)” |
ERROR: ...(标准错误) | 失败时 | 向用户展示错误消息 |
关键:一旦看到 TASK_SUBMITTED:,任务已在服务器上排队。不要再运行脚本。 重试会浪费用户的 API 配额。如果脚本本地超时,任务可能仍会完成——告知用户检查他们的仪表板 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image。
错误处理
提供友好、可操作的提示信息:
| 错误 | 告知用户什么 |
|---|---|
| 无效/缺失密钥 (401) | “您的 API 密钥似乎无效。您可以在 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 检查它” |
| 余额不足 (402) | “您的账户余额不足。您可以在 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 添加额度” |
| 频率限制 (429) | “请求过多——让我们稍等片刻再试一次” |
| 内容被拦截 (400) | “此输入被内容审核标记。请调整后重试” |
| 服务不可用 (503) | “服务暂时繁忙。请稍等一分钟后重试” |
模型能力总结
当用户询问模型能做什么时,使用以下信息:
- API 快速开始:创建任务,轮询完成状态,并检查最终响应。
- Agent 技能:使用 SKILL.md 及脚本来引导 Agent 执行。
- 故障排除:使用 docs/errors.md 和完整示例来调试常见故障。
- 发布准备:公开发布前保持包元数据的一致性。
参考资料
references/api-params.md:完整的 API 参数参考scripts/nanobanana-2-lite-image.sh:通过 EvoLink 运行 Nanobanana 2 Lite 图像生成任务。