用途:通过命令行调用 Google Nano Banana 2(Gemini 3.1 Flash Image)API,生成新图像或编辑已有图像。
主要能力:支持文本提示生成图像;支持以 --input-image 传入图片进行编辑(增删元素、改风格、调色等);输出分辨率可选 512、1K(默认)、2K、4K。
使用方式:从用户当前工作目录运行脚本(勿先进入技能目录)。生成:uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "描述" --filename "输出名.png" [--resolution 512|1K|2K|4K] [--api-key KEY]。编辑:追加 --input-image "路径/输入.png"。推荐流程:先用 1K 快速迭代,提示词确定后再用 4K 出终稿;编辑时每次迭代保持同一输入图。
API Key:依次读取 --api-key 参数、GEMINI_API_KEY 环境变量,两者均无则报错退出。需 uv 命令存在。
命名:建议 yyyy-mm-dd-hh-mm-ss-name.png,脚本拒绝覆盖已有文件、硬链接与符号链接。输出保存到当前目录,脚本打印完整路径,不回读图片。离线输出安全回归测试需 Pillow,从仓库根运行:python3 -m unittest discover -s skills/nano-banana-pro/scripts -p 'test_*.py'。
限制:API 报错可能源于密钥错误、无权限或配额超限;输入图路径无效或不可读会加载失败。其余收费、平台支持等信息暂未提供。