用途:使用 OpenRouter 专用 Image API 生成图像,并把返回的 base64 图像数据保存为文件。默认从当前环境读取 OPENROUTER_API_KEY;若缺失,脚本会自动向上查找最近的 .env 文件读取该变量,也可用 --api-key-env 或 --env-file 指定。
主要能力:通过捆绑脚本 scripts/openrouter_image_generate.py 发起生成,不手工构造请求。支持 --prompt 必填,--model 默认 bytedance-seed/seedream-4.5,--n 1..10、--resolution 512|1K|2K|4K、--aspect-ratio、--size、--quality、--output-format、--background、--output-compression、--seed、--reference(可多次,本地文件转 data URL)、--provider-options-json/--provider-options-file、--raw-json、--dry-run、--stream、--save-partials、--no-metadata。可运行 models 列出图像模型,endpoints --model 查看端点能力。
使用方式示例:python scripts/openrouter_image_generate.py generate --prompt "..." --model "bytedance-seed/seedream-4.5" --resolution 2K --aspect-ratio 16:9 --output-dir ./outputs。单图保存为 <output-prefix>.<ext>,多图加 _001 等后缀,默认另写 JSON 元数据。透明背景优先选原生支持透明输出的模型并传 --background transparent;不支持时才用 --remove-background 走本地色键抠图,且仅处理最终 PNG/WebP。
适用场景:需要以 OpenRouter 生成、渲染或保存图像时。
限制:生成会消耗用户 OpenRouter 账户额度,运行前应确认模型、数量与输出参数,不确定时用 --dry-run。不要打印或把 API key 写在命令行。色键抠图不适合毛发、羽毛、烟雾、玻璃、液体、半透明或反光主体。模型对参数支持不一,不支持项可能被忽略或拒绝;错误如 n 必须为 1、流式不支持 n>1、尺寸低于提供方下限、429 限流等需按提示调整。其他收费、价格与效果资料暂未提供。