## 功能特性 - 统一 OpenAI 图像接口：对外提供 `/v1/chat/completions`、`/v1/images/generations`、`/v1/images/edits`、`/v1/images/blend` 与 `/v1/models`，便于直接接入现有 OpenAI 生态。 - 双模式路由：既支持 Relay（客户端直接携带渠道 Key），也支持 Backend（平台内集中维护 Key 池与全局访问密钥）。 - 多渠道聚合：内置 Doubao、Gitee 模力方舟、ModelScope、HuggingFace、Pollinations 与 NewAPI 路由能力，可按模型和任务类型级联切换。 - 可视化运维：管理台提供渠道开关、Key 池、日志流、图片画廊、提示词优化器与版本检查，适合日常维护与回归排查。 ### 首次使用流程 1. 打开应用 2. 进入 `系统设置`，确认运行模式： - `中转模式`：客户端自己携带各家 Provider Key。 - `后端模式`：由 ImgRouter 管理 Key 池，并可额外设置 `全局访问密钥`。 3. 懒猫微服下 `服务端口` 会显示为固定托管端口，按钮文案为 `懒猫托管`；这里不支持在管理台里改端口或自重启。 4. 如果你准备用后端模式，先在 `系统设置` 中确认 `后端模式` 已开启；`全局访问密钥` 可以留空，留空时 `/v1/*` 不额外校验 Bearer。 5. 进入 `渠道设置`，按任务类型分别检查 `文生图`、`图片编辑`、`融合生图` 三类配置，确认目标渠道已经启用且模型下拉可见。 6. 进入 `Key池管理`，为目标渠道添加真实可用的 API Key。例如： - `ModelScope`：至少要有 1 条状态为 `已启用` 的 Key。 - `NewApi`：除了 Key 之外，还要确保条目里已经绑定 `URL`；如果界面里显示 `URL: 未设置`，运行时通常会拿不到模型。 7. 先用 `curl` 验证 `/v1/models` 是否已经能读到目标模型，再发正式生图请求： ```bash curl -s "https://img-router.你的盒子名.heiyu.space/v1/models" ``` 如果返回里能看到 `Tongyi-MAI/Z-Image-Turbo`、`Qwen/Qwen-Image-Edit`、`FLUX.1-dev` 等模型，再继续发送请求： ```bash curl -X POST "https://img-router.你的盒子名.heiyu.space/v1/images/generations" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <你的全局访问密钥或渠道Key>" \ -d '{ "model": "Tongyi-MAI/Z-Image-Turbo", "prompt": "一只坐在竹林石阶上的熊猫，国风水墨风格，晨雾，细节丰富", "n": 1, "size": "1024x1024" }' ``` 8. 成功后回到 `图片画廊`，确认能看到新生成的图片条目；如果页面仍显示 `暂无生成的图片`，优先查看 `仪表盘 -> 实时日志`。 ### 日常使用方式 1. 在 `仪表盘` 查看各渠道 Key 使用情况、成功率和日志流，快速判断当前是上游限流还是本地配置问题。 2. 在 `渠道设置` 为不同任务类型分别调整默认模型、默认尺寸和路由权重，给 `文生图`、`图片编辑`、`融合生图` 分开调优。 3. 在 `Key池管理` 中按渠道维护多个 Key，失效 Key 可以停用或删除，正常 Key 会按路由权重自动参与调度。 4. 在 `提示词优化器` 中配置一个额外的 OpenAI 兼容模型，为生图前的翻译、扩写或润色做预处理；真实界面会显示 `API Base URL`、`Model`、`API Key`、`启用翻译功能`、`启用扩充功能` 以及两段 System Prompt。 5. 在 `图片画廊` 中查看本地持久化的生成历史；如果没有成功生成，画廊会直接显示 `暂无生成的图片`。