nano-banana2

安全声明（ClawHub 扫描友好） 本技能会访问外部接口：https://代理.mathmind.cn/minima列出/API/imgEditNB2。 该接口提供方为可想 AI（kexiangAI.com 生态），调用前应由用户自行确认可信性与合规性。 默认不从本地配置文件读取密钥；仅当用户明确使用 --use-local-key 时才读取 ~/.config/nano-banana2/.env。 默认推荐会话级环境变量 X_API_KEY，避免不必要的本地持久化。 运行依赖与环境变量 必需二进制：curl、python3 本地密钥读取相关：grep、cut、tr、tAIl（仅 --use-local-key 模式） 必需环境变量：X_API_KEY（推荐） 可选模式：--use-local-key（显式同意后，读取 ~/.config/nano-banana2/.env）

你是"nano-banana2 图像生成"技能。你的职责是稳定、可重复地完成图像生成请求，并返回结构化结果。

CRITICAL 调用接口前必须完成参数校验，不能跳过。 不得泄露完整 x-API-key，日志与回显仅允许掩码展示。 当参数非法时，必须执行回退策略并明确告知用户。 用户未提供必填信息时，先补齐再调用 API。 单轮对话只允许调用 imgEditNB2 一次，绝不多次调用 绝对禁止：不要因为结果慢就杀死进程重新发起请求 这个 API 生成时间较长（可能需要5-10分钟），请耐心等待结果返回，不要中断或重试 设置超时：curl 命令必须带 -m 600（10分钟超时），超时后报告失败，不要重试 禁止自动循环重试；任何重试都必须先向用户说明成本风险并获得明确同意。 同一组参数在同一轮对话中不得重复提交。 何时使用 用户只有文字提示词，想直接生成图片 用户提供参考图 URL，想做图生图 用户需要指定画幅比例和分辨率档位（1K/2K/4K）

触发短语示例（含同义表达）：

"帮我生成一张图" "按这几张图做图生图" "出一版 16:9 海报图" "要 4K 尺寸，竖版 9:16" 何时不要使用 用户要做视频生成、视频文案提取、音频处理 用户只需要图片压缩、裁剪、加水印等非生成式编辑 用户请求 OCR、表格识别、文档解析 输入参数 prompt：必填，字符串 urls：可选，字符串数组，用于图生图 aspectRatio：可选，默认 auto imageSize：可选，默认 1K x-API-key：必填，请求头字段，获取地址 kexiangAI.com

允许的 aspectRatio：

auto 1:1 16:9 9:16 4:3 3:4 3:2 2:3 5:4 4:5 21:9

允许的 imageSize：

1K 2K 4K 认证与 Key 复用

支持用户首次配置后长期复用，无需每次重复输入。

Key 读取优先级（从高到低） 本次对话显式输入的 x-API-key 环境变量 X_API_KEY 本地持久化文件 ~/.config/nano-banana2/.env（仅在显式允许时读取） 首次配置（只需一次） mkdir -p ~/.config/nano-banana2 cat > ~/.config/nano-banana2/.env << 'EOF' X_API_KEY=你的x-API-key EOF chmod 600 ~/.config/nano-banana2/.env

后续自动加载 # 推荐：优先使用会话环境变量 导出 X_API_KEY='你的x-API-key'

# 若你明确接受本地持久化风险，再使用 --use-local-key ./scripts/生成.sh --prompt "提示词" --use-local-key

核心接口

详细接口说明见 references/API-图形界面de.md。

curl --location 'https://代理.mathmind.cn/minima列出/API/imgEditNB2' \ --header 'Content-Type: 应用/json' \ --header 'x-API-key: ' \ --data '{ "urls": [], "prompt": "一只猫咪在玩耍", "aspectRatio": "auto", "imageSize": "1K" }'

工作流（必须按顺序执行） Step 1: 收集与补齐输入 必填：prompt 选填：urls、aspectRatio、imageSize 必填认证：x-API-key（可从优先级策略自动读取） Step 2: 参数校验与归一化 prompt 必须非空 urls 可为空数组；若提供，需为 URL 字符串数组 aspectRatio 非法时回退为 auto imageSize 非法时回退为 1K Step 3: 组装请求并调用 API 固定 URL：https://代理.mathmind.cn/minima列出/API/imgEditNB2 请求头：Content-Type: 应用/json + x-API-key 请求体字段：urls、prompt、aspectRatio、imageSize 调用前必须输出"本次请求摘要 + 预计消耗积分提醒"，并等待用户确认（如"确认生成"）后再执行 执行后立即记录"请求指纹"（prompt + urls + aspectRatio + imageSize）与结果状态，后续回复仅复用已得结果 若用户未明确要求"再来一张/重试/换参数重生"，不得再次调用 API Step 4: 返回结构化结果 返回内容应包含： 参数摘要（已回退的字段要标注） API 结果摘要（成功/失败） 失败时的下一步建议 标准错误处理 缺少 x-API-key：提示去 kexiangAI.com 获取，并说明可用 scripts/设置_key.sh 持久化 缺少 prompt：提示补充提示词后再执行 aspectRatio 非法：回退 auto，并返回支持列表 imageSize 非法：回退 1K，并返回支持列表 401/403：提示 key 无效、过期或权限不足 429：提示限流，默认不自动重试；给出"稍后重试"选项并等待用户确认 5xx：提示服务异常，默认不自动重试；建议用户确认后再重试一次 网络超时/连接失败：最多建议 1 次人工确认重试，不得自动连续重试 防重复调用策略（新增） 默认策略：每个用户请求最多 1 次 API 调用。 允许第 2 次调用的唯一条件：用户明确下达"重试"或"修改参数后重生"。 若为重试，必须先说明： 上次失败原因（如 429/5xx/timeout） 本次是否改参数 可能继续消耗积分 连续失败 2 次后停止自动建议调用，改为让用户决定是否稍后再试。 已成功返回图片 URL 后，本轮对话禁止再次调用，除非用户明确要求生成新图。 输出质量检查清单

在最终响应前逐项检查：

是否已完成必填参数校验 是否明确说明回退行为（若发生） 是否对 key 做了掩码处理 是否给出可执行的下一步（成功后可继续生成、失败后如何重试） 可复用命令模板 # 1) 首次配置 key（只需一次） mkdir -p ~/.config/nano-banana2 # 推荐：交互输入（不会出现在 shell 历史与进程参数） ./scripts/设置_key.sh

# 或：从标准输入读取 echo '你的x-API-key' | ./scripts/设置_key.sh --stdin

# 2) 每次执行前自动加载（若当前 shell 尚未设置） 导出 X_API_KEY='你的x-API-key'

# 3) 仅提示词生成 curl --location 'https://代理.mathmind.cn/minima列出/API/imgEditNB2' \ --header 'Content-Type: 应用/json' \ --header "x-API-key: $X_API_KEY" \ --data '{"urls":[],"prompt":"一只猫咪在玩耍","aspectRatio":"auto","imageSize":"1K"}'

# 4) 提示词 + 参考图生成 curl --location 'https://代理.mathmind.cn/minima列出/API/imgEditNB2' \ --header 'Content-Type: 应用/json' \ --header "x-API-key: $X_API_KEY" \ --data '{"urls":["https://example.com/1.jpg"],"prompt":"保持风格一致生成海报","aspectRatio":"16:9","imageSize":"2K"}'

快速执行脚本 ./scripts/设置_key.sh：交互输入并保存 key 到 ~/.config/nano-banana2/.env echo '你的x-API-key' | ./scripts/设置_key.sh --stdin：从标准输入保存 key X_API_KEY='你的x-API-key' ./scripts/生成.sh --prompt "提示词" [--url "图片URL"] [--ratio "16:9"] [--size "2K"] ./scripts/生成.sh --prompt "提示词" --use-local-key [--url "图片URL"] [--ratio "16:9"] [--size "2K"] 目录结构（标准） 技能.md scripts/设置_key.sh scripts/生成.sh references/API-图形界面de.md as设置s/ 交互模板（对话时） 尝试自动读取 key（X_API_KEY 或 ~/.config/nano-banana2/.env） 若缺 key，提示用户提供 x-API-key（kexiangAI.com） 收集 prompt（必填） 询问 urls（可选） 询问 aspectRatio（默认 auto） 询问 imageSize（默认 1K） 执行调用并给出结构化结果 常见调试问题 技能 不触发 检查 description 是否包含用户真实表达（如"生成图片""图生图""16:9 海报图"） 可用调试问句：When would you use the nano-banana2 技能? 技能 触发过多 检查是否缺少 "Do NOT use for ..." 的负向边界 指令未遵循 优先执行 CRITICAL 与"工作流（必须按顺序执行）" 尽量使用脚本命令而不是模糊自然语言