用途：nano-banana-pro 用于根据文本提示词生成单张 PNG 图片，也可传入输入图片进行编辑。它被 meta-short-drama 用于逐镜头首帧生成，也可独立用于任意单图请求。
主要能力：支持 prompt（必填，纯英文提示词，可在文本中追加 --ar 9:16 等）、filename（必填，输出路径，相对路径基于进程工作目录）、aspect_ratio（可选，默认 1:1，可选 1:1、3:2、2:3、4:3、3:4、16:9、9:16）、image_size（可选，默认 1K，可选 1K、2K、4K，越高越慢越贵）、model（可选，默认 google/gemini-3.1-flash-image-preview，可用任意 OpenRouter 支持图片的模型）、max_retries（默认 0）、fallback_model（默认空）、placeholder_on_fail（默认 no，设为 yes 时若所有模型拒绝，则写入 720x1280 纯色 PNG 并标注 Scene placeholder）。编辑模式需直接调用脚本并传 --input-image PATH，meta-skill 引擎不通过 with: 路由输入图片。
鉴权：API key 解析顺序为 --api-key 参数、父级注入的 OPENSQUILLA_META_CAPABILITY_PROVIDER/API_KEY/BASE_URL 元组、OPENSQUILLA_META_OPENROUTER_API_KEY、OPENROUTER_API_KEY 环境变量。无需 Google Gemini key，OpenRouter 代为路由。
输出：打印保存 PNG 的绝对路径，并输出 IMAGE_GENERATION_RECEIPT 行，同时保存 <filename>.receipt.json，记录 provider、model、请求 id 及是否为真实结果或本地占位图，不含 API key 与 prompt。
限制：图片生成是付费且非幂等操作，脚本不会在收到任何 provider 响应、超时、连接丢失、响应异常、策略拒绝等模糊结果后自动提交第二次付费请求。重试与回退仅适用于明确分类的提交前失败。常见失败包括未找到 OpenRouter API key、模型拒绝提示词、HTTP 402/429（余额不足或限流）。1K 约 4-8 秒，2K 约 8-15 秒，4K 约 20-40 秒。