用途:调用 OpenRouter 上的图像生成模型生成或编辑高质量图片,覆盖照片写实、插画艺术、概念图、演示或文档视觉素材以及图像修改等通用需求。流程图、电路图、生物通路、系统架构、CONSORT 等技术示意图建议改用 scientific-schematics。
主要能力:支持生成与编辑两类任务。默认模型为 google/gemini-3.1-flash-image-preview,也提供 black-forest-labs/flux.2-pro(均支持生成与编辑),以及仅支持生成的 black-forest-labs/flux.2-flex。可按质量、编辑需求或成本选择模型。
使用方式:脚本为 scripts/generate_image.py。生成示例:python scripts/generate_image.py "A beautiful sunset over mountains";编辑示例:python scripts/generate_image.py "Make the sky purple" --input photo.jpg。常用参数包括 prompt(必填)、--input/-i、--model/-m、--output/-o、--api-key;默认输出 generated_image.png。结果以 base64 数据 URL 返回并自动保存为 PNG。
配置要求:需 OpenRouter API 密钥,可在项目或父目录的 .env 中设置 OPENROUTER_API_KEY,或用环境变量 export OPENROUTER_API_KEY=your-api-key-here;密钥获取地址 https://openrouter.ai/keys。脚本会自动检测 .env 并在缺失时给出提示。
限制:需安装 requests 依赖,生成时间通常约 5–30 秒;支持输入格式为 PNG、JPEG、GIF、WebP;费用与价格信息需参考 https://openrouter.ai/models,资料未提供具体收费与配额。