用途:通过 OpenRouter Image API 用统一请求调用 Gemini、Seedream、Recraft、GPT-Image、Riverflow 等模型,生成或编辑照片、写实图、插画、概念图、演示与海报视觉、标志与矢量标记,也支持基于参考图的编辑与合成。流程图、电路图、生物通路、系统架构、CONSORT 等科学示意图应改用 scientific-schematics。
使用方式:需 OpenRouter 密钥,解析顺序为 --api-key、OPENROUTER_API_KEY 环境变量、.env 文件中的 OPENROUTER_API_KEY(从工作目录向上搜索,再到脚本目录)。密钥可从 https://openrouter.ai/keys 获取。--list-models、--model-info、--dry-run 无需密钥。常用命令:python scripts/generate_image.py "A beautiful sunset over mountains";编辑示例:python scripts/generate_image.py "Make the sky purple" -i photo.jpg -o edited.png。命令须在技能目录运行,输入输出路径按工作目录解析,输出默认 generated_image.<ext>。
主要能力与限制:默认模型为 google/gemini-3.1-flash-image。各模型参数支持不同,CLI 会按模型目录校验并拒绝未声明选项,例如 gpt-image-2 不接受 --background transparent。常用参数含 -m/--model、-o/--output、-i/--input(可重复,接受本地路径、URL 或 data URL)、--n、--aspect-ratio、--resolution、--quality、--output-format、--background、--seed、--dry-run、--list-models、--model-info 等;无 --size。生成属付费 API 调用,计费为全有或全无;失败不收费,参数被拒也不收费。模型常无法正确渲染文字,建议要求“no text”并后期叠加真实文字。生成图仅为插画,不可作为数据或实验结果。参考图会上传至 OpenRouter,勿发送敏感或未公开数据。请勿硬编码密钥。注意 401 为凭证、402 为额度或消费限制、403 可能涉及权限、护栏或审核。超时默认 300 秒,会对 429 和部分 5xx 重试,生成中的传输失败不会自动重放。