ImageRouter

核心用法

ImageRouter 是一个 AI 图像生成的统一路由服务，允许用户通过单一 API 密钥访问海量第三方图像模型。核心功能包括：

双端点架构：

• /v1/openai/images/generations：纯 JSON 接口，适合简单文生图场景
• /v1/openai/images/edits：multipart/form-data 统一端点，同时支持文生图、图生图、局部重绘（inpainting）及最多 16 图的多图融合

关键参数：model（必需）、prompt、quality（auto/low/medium/high）、size（auto 或自定义分辨率）、response_format（url/b64_json/b64_ephemeral）、output_format（webp/jpeg/png）

显著优点

1. 模型聚合：无需对接多个服务商，单密钥调用 Gemini、Stable Diffusion、FLUX 等主流模型
2. OpenAI 兼容：接口设计对标 DALL-E，降低迁移成本
3. 灵活输出：支持 URL 直链、Base64 编码、无痕模式（b64_ephemeral）
4. 多模态编辑：单端点覆盖文生图、图生图、mask 局部编辑、多图合成
5. 成本透明：响应体直接返回 cost 字段，便于计费追踪

局限性与风险

• 依赖外部服务：图像生成完全依赖 ImageRouter 后端稳定性，无本地 fallback
• API 密钥安全：明文密钥在命令行传递，存在 shell 历史泄露风险
• 模型黑盒化：实际调用哪个底层服务商对用户不可见，调试困难
• 速率与配额：未在文档中说明限流策略，生产环境需自行压测
• 合规盲区：生成内容的版权、NSFW 过滤策略取决于底层模型，责任边界模糊

适合人群

• 需要快速对比多模型效果的开发者/设计师
• 已熟悉 OpenAI 图像 API、希望扩展模型选择的技术团队
• 原型验证阶段，追求接入效率而非深度定制的项目

常规风险提醒

⚠️ 密钥管理：避免将 YOUR_API_KEY 硬编码入脚本或提交至版本控制，建议使用环境变量或密钥管理器注入
⚠️ 成本失控：test/test 模型虽标注为免费测试，但生产模型按次计费，需配合响应体的 cost 字段建立预算告警
⚠️ 数据隐私：b64_ephemeral 模式声称不保存日志，但需自行审计服务商实际数据保留策略

核心功能

ImageRouter 是一个第三方 AI 图像生成 API 聚合平台，本 Skill 为纯 Markdown 文档，提供完整的 API 调用指南。支持通过统一接口调用 1000+ 图像生成模型，涵盖文生图、图生图、局部重绘（inpainting）等能力。

显著优点

模型生态丰富：支持 Gemini、Stable Diffusion、FLUX 等主流及小众模型，可按热度、日期筛选，满足多样化创作需求。

接口兼容性强：提供 OpenAI 风格的 /v1/openai/images/generations 和 /edits 端点，降低迁移成本；同时支持 JSON 和 multipart/form-data 两种请求格式。

功能覆盖全面：从基础文生图到复杂的多图融合（最多 16 张）、蒙版编辑，参数体系完整（quality、size、response_format、output_format 等）。

无代码安全风险：纯文档型 Skill，仅含 curl 示例，无可执行代码、无依赖、无敏感信息硬编码，通过 S 级安全认证。

潜在局限

第三方服务依赖：ImageRouter 为独立商业服务，非官方大厂出品（T3 来源），需自行承担服务稳定性、数据隐私及长期运营风险。

API 密钥成本：核心功能需付费 API 密钥，无免费额度说明；成本按调用计费（示例显示单次约 $0.004）。

学习曲线存在：模型选择、参数调优（quality/size/output_format 组合）需一定实验，文档未提供详细错误码说明。

适合人群

• 需要通过统一接口快速切换多家 AI 图像模型的开发者
• 偏好命令行/curl 工作流的技术用户
• 需要图生图、多图融合等进阶功能的中高级用户
• 对 Skill 安全性敏感、拒绝安装含代码插件的保守用户

常规风险

| 风险类型 | 说明 |

|---------|------|

| 数据隐私 | 提示词及上传图片需传输至 ImageRouter 服务器，需审阅其隐私政策 |

| API 密钥泄露 | curl 命令需填入真实密钥，建议通过环境变量注入，避免历史记录残留 |

| 服务中断 | 第三方平台存在停服、涨价或模型下线风险，不宜用于关键业务 |

| 内容合规 | 生成内容受模型提供商及 ImageRouter 双重审核策略约束 |

使用建议

1. 访问 https://imagerouter.io 核实服务资质与最新定价
2. 使用 test/test 免费模型验证集成，再切换至生产模型
3. 敏感场景优先选用 b64_ephemeral 响应格式，减少日志留存
4. 定期监控 API 用量与账单，设置用量上限防止意外消费