用途:该技能用于借助 OpenRouter 调用 google/gemini-3-pro-image-preview 模型,完成三类图像任务:仅凭提示词生成图像、对单张输入图进行编辑、以及将多张输入图合成为一张图像。
主要能力:支持通过重复传入 --input-image 最多接收 3 张输入图像;支持用 --resolution 指定 1K、2K 或 4K 分辨率,未指定时默认 1K;--filename 可接受相对路径(保存到当前目录)或绝对路径;若返回多张图像,会在文件名后追加 -1、-2 等后缀。技能会读取可选的 assets/SYSTEM_TEMPLATE 系统提示词,可在不改代码的前提下自定义生成行为。每保存一张图像会输出 MEDIA: <path>,不会把图像读回响应。
使用方式:纯提示词生成示例为 uv run {baseDir}/scripts/generate_image.py --prompt "A cinematic sunset over snow-capped mountains" --filename sunset.png;单图编辑需增加 --input-image input.jpg;多图合成可重复传入 --input-image face1.jpg --input-image face2.jpg。
限制与排错:脚本非零退出时需检查 stderr。OPENROUTER_API_KEY 未设置时需用户自行设置,PowerShell 为 $env:OPENROUTER_API_KEY = "sk-or-...",bash 为 export OPENROUTER_API_KEY="sk-or-..."。若提示 uv 命令不存在,macOS/Linux 用 curl -LsSf https://astral.sh/uv/install.sh | sh,Windows 用 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex",然后重启终端。遇到 AuthenticationError 或 HTTP 401,说明密钥无效或无额度,需在 https://openrouter.ai/settings/keys 核实。对于 HTTP 429、网络超时等临时错误,可在 30 秒后重试一次;同一错误不要重试超过两次,应把问题反馈给用户。