Communitygithub.com

Evolink-AI/nanobanana-2-lite-image-generate-api-skill

Nanobanana 2 Lite 图像生成 API 示例及面向 EvoLink 的可安装 Agent 技能。

nanobanana-2-lite-image-generate-api-skill 是什么?

该技能将 Nanobanana 2 Lite 图像生成模型封装为 EvoLink API 端点,并附带一个可直接安装的 Agent 技能。它支持在 Claude Code、Cursor、Codex 等 AI Agent 中无缝调用。技能的核心流程包括:检查 EvoLink API 密钥、理解用户意图、按需收集参数(如提示词),然后通过脚本执行图像生成任务。执行过程中会实时推送状态更新,最终返回结果 URL。该技能严格遵循“一次性执行”原则,避免重复提交任务浪费配额,并提供完善的错误处理指导,帮助开发者快速集成与调试。

兼容平台✓Claude Code~Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add Evolink-AI/nanobanana-2-lite-image-generate-api-skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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。

安装后

当此技能首次加载时,主动问候用户并启动设置流程:

  1. 检查是否设置了 EVOLINK_API_KEY(运行:echo $EVOLINK_API_KEY)

  2. 就这样。只问一个问题。用户现在进入流程。

不要列出功能、显示菜单或倾倒说明。只需问一个问题以推进。

核心原则

  1. 引导而非决定 — 提供选项,让用户决定。不要对他们的偏好做假设。
  2. 让用户主导 — 如果他们有想法,使用他们的措辞。如果他们需要灵感,提供建议并让他们选择或细化。
  3. 智能上下文感知 — 识别用户已经提供的信息,只询问缺失的部分。
  4. 意图优先 — 如果用户意图不明确,先确认他们想要什么,然后再继续。

流程

步骤 1:检查 API 密钥

如果用户尚未提供 API 密钥或未设置 EVOLINK_API_KEY:

如果密钥已设置或已提供,直接跳到步骤 2。

步骤 2:理解意图

根据用户的消息评估他们想要什么:

  • 意图明确(例如,“用一个简短的提示词运行 Nanobanana 2 Lite 图像生成”) -> 进入步骤 3
  • 意图模糊(例如,“我想试试”) -> 询问他们想做什么。

步骤 3:收集缺失信息

检查用户已提供的内容,仅询问缺失的部分:

参数告知用户什么是否必需
待定待定是
待定待定是
待定待定可选
待定待定可选

智能收集规则 — 严格:

  • 在一次消息中询问所有缺失的参数。 绝不要分成多轮提问。
  • 永远不要重复提问。 如果用户已经回答了某个参数,那就是最终答案——不要再次询问。
  • 预先提供默认值,以便用户可以说“默认即可”:model=gemini-3.1-flash-lite-image, prompt='创建一个简短的演示'。如果用户说“默认”或“直接开始”,立即使用这些值。
  • 用户一次性给出所有信息 -> 确认并立即运行模型,不再提问。
  • 用户给出部分信息 -> 仅询问剩余的必需字段,全部放在一条消息中。
  • 可选参数都有合理的默认值——如果用户跳过它们,使用默认值并继续。

步骤 4:执行

一旦所有必需信息确认:

  1. 在运行脚本之前,立即告知用户:“收到!我将通过 EvoLink 运行 Nanobanana 2 Lite 图像生成。”
  2. 只运行一次脚本。除非用户明确要求重试,否则绝不要再次运行。
  3. 完成后,分享结果和耗时。

各代理的执行模式

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

所有代理 — 关键规则:

脚本用法

记住:将 {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 图像生成任务。

相关技能