核心用法
baoyu-imagine 是一款基于官方API的多服务商AI图像生成工具，采用TypeScript/Bun运行时架构，支持9大主流平台：OpenAI、Azure OpenAI、Google Gemini、OpenRouter、阿里云DashScope（通义万象）、MiniMax、即梦Jimeng、豆包Seedream及Replicate。
基础工作流：
1. 首次配置：自动检测或创建 EXTEND.md 配置文件，设置默认服务商、模型、画质与输出路径
2. 单图生成：通过 --prompt 传入文本描述，--image 指定输出路径，支持 --ar 比例、--size 自定义尺寸、--quality 画质预设
3. 参考图生成：--ref 参数支持Google、OpenAI、Azure、OpenRouter、MiniMax、Seedream等平台的图生图/风格迁移
4. 批量生成：--batchfile 读取JSON任务队列，自动启用并行工作流，支持多worker并发与失败重试
高级特性：
- 智能模型路由：自动根据可用API Key选择服务商，支持CLI参数 > 配置文件 > 环境变量的优先级覆盖
- 多平台参数映射：自动处理各平台差异（如Google的
imageSize、OpenAI的size、DashScope的宽*高格式、MiniMax的aspect_ratio） - 中文优化：DashScope
qwen-image-2.0-pro专门针对中文排版与自由尺寸优化，支持21:9横幅等非常规比例
显著优点
1. 生态覆盖全面：同时支持国际主流（OpenAI/Google）与国内头部平台（阿里、MiniMax、字节、即梦），无需切换工具即可对比各平台生成效果
2. 配置即代码：EXTEND.md + 环境变量的多层配置体系，支持项目级与用户级偏好隔离，便于团队协作
3. 批量生产效率：内置并行生成引擎，自动限流与3次失败重试，适合电商素材、游戏资产、媒体配图等规模化需求
4. 参考图工作流成熟：MiniMax image-01 的人物一致性、Seedream 5.0的风格保持、Google多模态的编辑能力均有针对性支持
5. 运行时轻量：基于Bun/NPX，无Docker依赖，跨平台脚本统一
潜在缺点与局限性
1. 首次配置门槛：必须完成EXTEND.md初始化才能执行生成，对新用户不够友好
2. 服务商能力参差：部分平台（如Jimeng、Seedream 3.0）不支持参考图功能；Azure/OpenAI的部署名称需手动映射，易配置错误
3. 参数翻译非官方：--quality 到各平台原生参数的映射为工具层推断，非API原生保证，极端场景可能偏差
4. 中文文档依赖：DashScope、MiniMax等国内平台的官方文档链接为中文，国际化用户可能受限
5. 并行模式限制：仅--batchfile模式支持并行，单图多参数变体仍需串行或外部脚本编排
适合人群
- 设计师/创意工作者：需要快速对比多平台出图效果，批量生成营销素材
- 开发者/MCP用户：通过CLI集成到自动化工作流，如CI/CD生成文档配图、游戏动态资产生成
- 跨境电商运营：利用MiniMax人物一致性或DashScope中文排版优势，高效产出本土化视觉内容
- AI应用开发者：需要统一接口层屏蔽各平台差异，快速切换底层模型
常规风险
1. API密钥安全：需在环境变量或.env文件中配置9家服务商的密钥，存在泄露风险；建议配合密钥管理工具（如1Password CLI、AWS Secrets Manager）使用
2. 成本失控：批量生成时尤其Replicate按秒计费、OpenRouter按token计费，需设置BAOYU_IMAGE_GEN_MAX_WORKERS限流并监控用量
3. 内容合规：各平台内容政策差异大（如国内平台对特定题材的审核），生成前需了解目标平台限制
4. 输出覆盖：未自动检测文件冲突，--image指定路径已存在将直接覆盖，建议配合版本控制或输出目录管理