用途:调用 grsai.com 的 Nano Banana 2 API 生成新图像或编辑已有图像,适用于文生图与图生图请求。
主要能力:支持 1K(约1024px,默认)、2K(约2048px)、4K(约4096px)分辨率;宽高比通过 --aspect-ratio 指定,可选 auto(默认)、1:1、16:9、9:16、4:3、3:4、3:2、2:3、5:4、4:5、21:9。默认开启提示词增强(经 Gemini 3.1 Pro),可用 --no-enhance 跳过;增强失败时回退使用原始提示词。
使用方式:在用户当前工作目录运行脚本(不要先 cd 到技能目录)。生成:uv run scripts/generate_image.py --prompt "描述" --filename "输出名.png" [--resolution 1K|2K|4K] [--api-key KEY] [--no-enhance]。编辑:加 --input-image "路径"。API Key 依次取 --api-key 参数或 GRSAI_API_KEY 环境变量,均无则报错退出。建议先 1K 草稿迭代,提示词确定后再用 4K 出终稿。文件名建议用 yyyy-mm-dd-hh-mm-ss-名称.png。
限制:需有效 API Key;输入图路径须存在可读;内容审核或无效输入会导致生成失败,需改写提示词;uv 未安装可用 curl -LsSf https://astral.sh/uv/install.sh | sh 安装。脚本对瞬时错误自动指数退避重试,全部失败后向用户报错。输出仅保存到当前目录并返回完整路径,不回读图像。
适用场景:图像创建、风格转换、增删元素、调色、背景虚化等编辑任务。