generate-nanobanana 是一个通过 Google Gemini API 直接调用 Google Gemini 媒体模型来生成和编辑图片与视频的技能，不经过第三方路由层。它可以按任务将每次请求路由到合适的模型层级，并注册了一个 /generate 命令。
用途
- 当用户要求生成、创建或制作图片或视频，或需要缩略图时使用。
- 当用户希望让静态图片动起来，或说出“按品牌生成”“基于参考图生成”时使用。
- 当用户希望链接或导入一个参考图片文件夹（如 logo、人脸、产品图），以便在多次生成中复用时使用。
- 当用户调用 /generate 或 /generate frf <set> 时使用，即使没有指定具体模型。
主要能力
- 模型路由：根据任务选择模型。图片草稿使用 Nano Banana 2 Lite（gemini-3.1-flash-lite-image）；图片标准使用 Nano Banana 2（gemini-3.1-flash-image）；图片质量与多图融合使用 Nano Banana Pro（gemini-3-pro-image）；视频使用 Gemini Omni Flash（gemini-omni-flash-preview）。四个模型均通过 Interactions API 调用。
- 参考图片处理：从 generations/refs/ 或指定的参考集载入真实参考图片。参考集可通过导入（复制文件到 generations/refs/<set>/）或链接（在 generations/refs/sets.json 记录源路径）方式注册。参考集可携带 style.md，其内容会原样前置到由该参考集生成的每个提示词中。
- 成本审批门：每次生成（图片或视频）都计费，需要明确批准。需从实时定价页面引用所选模型的当前单价，并在该次调用前获得用户明确同意。一次批准只覆盖一次调用，重新运行需要再次批准。生成需逐个进行，不能并行。
- 校验与日志：确认生成文件存在且非空后，在其旁边写入匹配的 .json 附属日志，记录模型 ID、提示词、使用的参考图、响应 ID、成本和时戳。失败或被安全拦截的调用不写日志。
使用方式
- 典型流程为：先路由到模型并阅读 references/ 下对应参考文件以获取当前请求格式，然后载入参考图片，接着在获得成本批准后调用 Gemini API，最后校验输出并写入附属日志。
- 需要 Google AI Studio API 密钥（GEMINI_API_KEY），在 Antigravity 原生工具回退之外还需要 google-genai Python 包。
- 文件写入限定在工作区的 generations/ 文件夹内，包括 generations/refs/、REST 请求/响应文件和 sets.json。
适用场景
- 按品牌风格生成缩略图、动画化静态图片、基于参考图生成、导入参考图集以便复用等。
限制
- 仅覆盖 Google Gemini 模型，没有到其他图片/视频生成器的多提供商路由。
- 没有模型记录 seed 或可复现性保证；重新运行只能通过保存的提示词和参考图尽力还原，不保证输出相同。
- 模型 ID 和定价由 Google 自己决定变更；参考文件中的模型 ID 是最后更新时验证的，需对照实时文档重新核实。
- 该技能不替代针对具体环境的验证、测试或对生成资产的专家审查。
- 如果缺少必需的参考图片、权限或 API 密钥，应停止并请求澄清。
安全与安全说明
- 网络：生成和文件传输调用发往 generativelanguage.googleapis.com；检查当前文档或定价会访问 ai.google.dev；明确批准的包安装会访问配置的 PyPI 索引。不向任何其他端点发送提示词或参考媒体。
- 密钥：GEMINI_API_KEY 仅从环境或用户已设置的工作区 .env 读取，从不记录、打印或写入附属日志、提示词或提交文件。该技能本身不创建或编辑 .env、.env.example 或 .gitignore。
- 文件写入：技能创建的项目输出限制在工作区的 generations/ 文件夹内。
- 包安装：仅安装官方 google-genai PyPI 包，且仅在缺失时安装。
- 成本：每次调用都会消耗用户 Google AI Studio 计费的真实费用。