技能介绍

要解决什么问题

对接 Nano Banana Pro 这类按次计费的图像 API 时，Agent 很容易在重试、参数微调或「再试一次」的语境里重复发起同一请求，费用会直接叠加。本技能把目标收窄为：在单次用户意图下，安全、可控、可审计地完成文生图或图生图，并把「最多调用一次」写成硬约束，而不是口头提醒。

技能如何工作

参数收集与校验：必填 prompt；可选 img_url（最多 14 张参考图 URL）、aspectRatio（非法值回退 auto）、imageSize（非法值回退 1K）。x-api-key 走请求头，展示时只允许掩码，不得泄露完整 Key。
先摘要、再调用：归一化后输出本次 request_summary，等待用户明确确认（例如「确认生成」）后才调用 imgEditNBP。
单轮单次：同一轮对话里只允许调用一次；curl 需带 -m 600 超时，超时即失败返回，不自动重试。
防重复提交：对 prompt + img_url + aspectRatio + imageSize 计算指纹；同参重复请求默认拒绝，除非用户明确要求并显式允许重复（如 --allow-duplicate）。
结构化结果：返回 success/failed、image_url 或 error，以及 next_step（若需再次调用，必须再次取得用户确认）。

Key 读取顺序为：对话中显式提供的 x-api-key → 环境变量 X_API_KEY → 本地 ~/.config/nano-banana-pro/.env（仅用户显式允许 --use-local-key 时）。

适用边界与注意点

适合：仅给提示词做文生图；提供 1～14 张参考 URL 做图生图；需要指定画幅比例或 1K/2K/4K 分辨率。
不适合：视频生成或视频处理；OCR、识别、压缩、裁剪等非生成式能力。
计费风险：误触发重试或重复提交会产生额外费用；同参数默认拒绝重复，这是设计行为而非故障。

截图预览

使用场景

活动或文章定稿后，仅凭一段 `prompt` 生成封面图，并需在确认画幅比例（如 `16:9`）与分辨率后再发起唯一一次 API 调用。
手头有 1～14 张参考图 URL，要在固定提示词下做图生图，且同一轮对话里禁止自动重试或同参重复提交。
在 Agent 工作流中接入 Nano Banana Pro，必须先输出 `request_summary`（含回退后的 `aspectRatio`/`imageSize`），等用户明确确认后才调用 `imgEditNBP`。
需要按指定比例（如 `9:16` 竖图）或 `2K`/`4K` 输出成品图，同时把超时（600s）失败当作终态，不隐式重放请求。