用途:该技能用于调用 Gemini 的 Nano Banana 图像模型生成、编辑和合成图像,脚本由 uv 管理,可移植运行。
主要能力:生成图像(根据文本提示词);编辑图像(基于文本提示修改已有图片);合成图像(依据多张输入图片和提示词生成新图)。
认证方式(需在环境中配置其一):API Key 使用 GOOGLE_API_KEY 或 GEMINI_API_KEY;Vertex AI 使用 GOOGLE_CLOUD_PROJECT、GOOGLE_CLOUD_LOCATION 并设置 GOOGLE_GENAI_USE_VERTEXAI=1。
使用方式:生成图像前先确认参数(提示词、模型、宽高比、安全过滤),默认模型为 gemini-3-pro-image-preview,默认宽高比 1:1,默认安全过滤 BLOCK_MEDIUM_AND_ABOVE。生成命令:uv run skills/nano-banana-use/scripts/generate_image.py "A futuristic banana city" --output city.png。编辑命令:uv run skills/nano-banana-use/scripts/edit_image.py original.png "Make the sky purple" --output edited.png。合成命令:uv run skills/nano-banana-use/scripts/compose_image.py --image style.png --image subject.jpg "A painting of the subject in the style of the first image" --output composition.png。
可用选项:prompt 为图像文本描述;--model 指定模型,默认 gemini-3-pro-image-preview;--output 指定保存文件名,默认 generated_image.png;--aspect-ratio 指定宽高比,默认 1:1,支持 1:1、16:9、4:3、3:4、9:16;--safety-filter-level 指定安全过滤阈值,默认 BLOCK_MEDIUM_AND_ABOVE。
适用场景:需要以脚本方式批量或自动化完成图像生成、局部修改与多图风格合成时使用。
限制:需预先配置上述认证环境变量;具体模型可用性、配额、计费与平台支持情况暂未提供。