MG-01-004 产品范围
状态说明：以当前有效边界为准。供应执行规则与历史实现证据保留；客户身份、售价、结算、全量旧跨仓契约及图像开放计划不代表当前验收范围。
当前范围由 D-024/D-022 修订：仅内部视频供给服务。用户、客户组、客户 Key、模型广场、 新平台售价与结算归 Core，new-api 为统一供应入口；本轮不开放图像入口。下文为历史首版范围，冲突处不再有效。 当前实施契约见 内部视频服务。
1. 产品目标
系统只服务图像和视频生成，不承担通用 AI 聚合平台职能。核心目标是：
- 管理员通过 Provider Base URL 与 API Key 发现并配置上游模型；
- 将每个上游模型能力版本建成可独立测试、计价、限流和熔断的供给 SKU；
- 根据请求能力、真人政策、动态健康、容量和成本选择供给；
- 多渠道同时消费请求队列，最大化可用并发；
- 区分用户内容错误和上游故障，避免无意义重试；
- 精确供给全部不可用时，按预先批准的降级链尽可能完成生成；
- 为管理员和用户提供清晰的模型、状态、使用记录和任务结果。
2. 用户角色
普通用户
- 查看所属客户组允许使用的公开模型；
- 创建、禁用和删除自己的 API Key；
- 调用图像与视频 API；
- 查看自己的数据看板和使用记录；
- 查询自己的异步任务与结果；
- 查看 API 文档。
管理员
- 管理用户、客户组和 API Key；
- 配置渠道账户和 Provider Credential；
- 发现、导入和测试上游模型；
- 配置供给能力、成本、容量和真人政策；
- 配置公开模型、供给绑定、调度策略和降级链；
- 查看全站使用记录、健康、队列、成本和告警；
- 管理必要的网关、存储、任务和告警设置。
- 分别管理图像 Channel/Supply 与视频 Channel/Supply，不创建混合媒体 Channel；
- 按渠道模型查看调用量、成功率和错误统计，并调整新任务使用的 Binding 与策略。
3. 首次发布必须包含
供给管理
- Provider 连接测试；
- 模型列表发现；
- 模型列表变化检测；
- Provider 支持时发现价格；
- 手工成本录入与覆盖；
- 图像与视频能力分别配置；
- 单个供给真实测试；
- 渠道级与供给级启停；
- 价格和能力配置版本。
公开模型
- 模型广场；
- 客户组可见与可调用范围；
- 精确、兜底和降级供给；
- 稳定优先或成本优先；
- 健康和容量状态摘要；
- 公开能力、限制和可能发生的降级说明。
- 按模型、分辨率、431/933 素材配置和按秒/按条计费方式展示配置价格。
- 每个规格配置系统默认售价，并可为单个用户配置专属售价；模型广场展示当前用户有效价 及其对应默认价。
执行
- OpenAI 兼容图像同步接口；
- 图像显式异步扩展；
- OpenAI 兼容视频异步接口；
- ByteDance ModelArk 兼容视频创建与任务查询接口；
- 异步任务查询；
- Provider 错误分类；
- 初次提交加一次换供给重试；
- 20 分钟重试截止时间；
- 多供给容量并行利用；
- 渠道与供给独立熔断；
- 预定义能力降级。
数据与运营
- 统一使用记录；
- 异步任务详情和 Attempt 时间线；
- 预计与实际 Provider 成本；
- 降级和重试标记；
- 数据看板；
- 健康与告警；
- 平台控制的素材和生成结果存储。
4. 明确不做
- 聊天和 Playground；
- 文本、语音或通用多模态网关；
- 在线支付、充值、订单、订阅、余额和兑换码；
- 面向用户的价格购买体系；
- 客户组价格、余额扣减和账单结算；
- 个人资料或个人资料管理页面；
- 复杂 OAuth、邀请、公告和工单系统；
- 用户选择 Provider、渠道或调度策略；
- 渠道数字优先级、权重、亲和度；
- 机器学习路由或任意脚本路由；
- 任意模型临时替代任意模型；
- 未经配置声明的静默参数修改；
- 长期并行运行旧媒体调度和新媒体调度。
5. UI 范围
普通用户导航：
- 数据看板
- 模型广场
- API Keys
- 使用记录
- API 文档
管理员增加：
- 图像渠道
- 图像模型路由
- 视频渠道
- 视频模型路由
- 用户与客户组
- 健康与告警
- 核心设置
不存在独立个人资料页面。头像菜单只显示当前用户和退出登录；必须的密码修改可以 使用弹窗。
6. 成功标准
- 管理员配置一个新渠道时不再重复配置“渠道模型”和“供给路由”；
- 某渠道的单个模型故障不会停止该渠道的其他模型；
- 多个可用渠道能够同时承接不同任务；
- 内容错误不会触发换渠道，上游故障最多换供给一次；
- 同步图像保持同步，不进入长队列；
- 异步视频和显式异步图像具有稳定平台任务 ID；
- 每次路由、重试、降级、成本和失败都可解释；
- 管理员可以在一个页面判断公开模型是否拥有健康精确供给；
- 管理员可以在对应媒体控制台看懂选择顺序、暂停或启用 Binding、调整供给角色和策略；
- 管理员可以按渠道的具体模型查看调用量、成功率、错误分布、趋势和最近失败；
- 用户可以在统一使用记录中看到图像和视频的实际状态。