MG-02-002 产品与工作流
状态：建议稿；已确认方向及待定决定见 入口。这里定义用户流程，字段见 02，执行规则见 03。
产品是什么
这是一个能独立运行的视频供应网关，提供供应管理 UI 和稳定的视频 API。管理员把上游渠道、型号、规格、采购价格和可用性配置好；调用方选择标准模型及参数，网关完成选路、提交、轮询、存储结果，并留下能追查的生成记录。
业务链路为“调用方 → 媒体网关 → Provider”，结果由媒体网关转存 TOS 并授权交付。调用方可以是 Core Worker、产品后端或获准的内部服务；new-api 只是可能的兼容调用方，不是运行前置。前端不连接 Provider，不持有 TOS 或供应密钥，不自行重新提交失败任务。
管理员负责渠道接入、参数/价格维护、模型路由、验证、记录排查和停用。调用方负责自己的客户身份、商业价格和产品流程；网关只保存必要的外部关联标识，不借兼容数据库行建立新的客户账务体系。首轮不包含日常视频工作台、产品画布、分镜编辑、客户钱包、充值与模型商城。站内真实测试是明确的运维入口，复用实际 API 执行链。
六个日常流程
1. 接入渠道
- 在“渠道”新增名称、协议/适配器、地址和凭据。协议有合理默认路径，高级覆盖可展开；未知协议明确显示需适配，不能让管理员上传动态插件碰运气。
- 一次保存得到停用渠道；密钥回读只返回掩码、版本和更新时间。
- 点击“检查连接”就显示结果。它只检查鉴权和非付费读取，不生成视频，也不弹额外确认。
- 点击“读取模型”得到可导入目录与与现有配置的差异；选择项目后导入为草稿。支持手动添加目录未列出的型号，必须标记来源。
- 在渠道型号表中补齐参数、规格映射和采购价格；只在这一处修改。
- 按已配置规格发起一次明确的真实调用测试，按钮注明上游可能收费，普通配置无二次确认。测试即持久任务，离开页面后可在生成记录继续看进度和结果。
- 确认该规格通过并满足启用门禁后启用；未测试或失败规格仍停用。渠道连接成功不能代替这一步。
UI 中可以连贯完成以上工作，但不能把“建立连接、发现型号、真实验证、启用”合成一个会偷偷付费的按钮。步骤表示业务事实，不要求每步都走向导或确认弹窗。
2. 日常维护参数、价格和凭据
进入渠道详情即可看见连接概况与型号/规格表。常用字段原位编辑，复杂参数打开固定编辑区。参数范围、原始型号和采购报价在同一表单，一次保存；执行成本从同一版本计算，不再要求另一个页面再录一遍。
保存前页面显示改动与受影响规格。名称/说明改动不影响在途任务；价格更新影响之后接受的新任务；协议、凭据、原始型号或关键能力变化按 02 生效规则 暂停受影响供给并要求重新验证。冲突时保留草稿，提供当前版本对比，不能偷偷覆盖别人。
目录同步先展示差异，管理员选择应用；不会自动删除旧型号、启用新规格、覆盖人工参数或重写正在执行任务。凭据轮换不泄露旧密钥，不要求逐个规格重填同一份凭据。
3. 配置模型与调度
“模型与调度”按调用方标准模型组织。每个模型下选择已有渠道供给，设置参与状态和排序/策略。这个页面只做路由：价格、上游型号、素材限制显示为引用，点击可进入渠道维护，不能再填一份。
用一组请求参数进行“模拟选路”，看候选、预计成本、排除原因和最终选择；模拟不调用付费提交。模型保存与启用使用明确按钮和行内状态；不能每次改一个排序就强制整个模型停服并再去另一页发布。在途任务使用已固定版本，新任务使用新生效版本。模型提供真实路由测试，渠道规格提供固定供给测试；两者都是运维测试入口。
4. 调用方生成
调用方用独立服务认证提交标准模型、提示词、时长/比例/分辨率及素材引用，附稳定幂等键和业务关联 ID。网关先校验并持久化任务，再异步执行，返回可查询 ID。
合法请求没有可用供给时给出安全且可理解的状态或错误；临时容量不足按已配置队列规则等待，永久参数不匹配立即拒绝。既有 OpenAI/ModelArk 响应形状保持兼容；管理界面展示更完整的内部状态，不能为 UI 便利改坏兼容 API。
提交超时后调用方查询原 ID 或按同一幂等键取回任务；网关、调用方和 Provider 层都不能因此各自重提。调用方通过平台结果入口读取文件，不需要配置桶或掌握供应凭据。
5. 查看生成记录与结果
进入“生成记录”默认看到所有 API 任务与供给测试。每个逻辑请求只有一条主记录，多次执行在详情中展开。可按时间、标准模型、渠道、用途、状态、任务 ID 查询；详情优先展示结果或当前处理状态，然后输入、参数、成本和执行过程。
成功结果可直接播放、拖动进度、下载；上游生成完成而转存失败时显示“结果处理中/转存待恢复”，不能显示绿色成功但无文件。失败显示明确原因；提交未知显示“待核对”，提供查询/核对入口而不是“重试生成”。
固定供给测试不自动换渠道；完整路由测试按配置 0/1 重试。测试页提交后进入相同任务详情。刷新、关闭标签页、退出登录均不取消已接受任务；再次打开可以恢复查看。
6. 停用、归档与恢复
停用阻止新的选路，已接受任务按固定版本继续执行与轮询。归档用于隐藏不再维护的渠道，同时停用其供给，但保留凭据引用、配置版本、记录与结果。归档前只有一次清晰确认，列出影响。
恢复渠道得到停用状态，不能恢复即自动接收流量。硬删除涉及历史引用不作为日常入口。旧 6 个归档渠道的运行配置/凭据原地保留；相关历史任务也迁入，以只读来源关联，不自动恢复渠道。所有历史永久保留，导入见 08。
关键异常与用户下一步
| 情况 | 平台展示 | 用户可以做什么 | 平台不能做什么 |
|---|---|---|---|
| 鉴权失败 | 指向渠道凭据并列出受影响供给 | 修改/轮换凭据，再检查与验证 | 展示真实密钥、拖垮其他渠道 |
| 型号支持资料不足 | 草稿及缺失项 | 手工补充带来源的配置 | 猜测能力后启用 |
| 上游限流/容量不足 | 等待或容量暂不可用 | 看队列、调整自己的容量 | 每次刷新重新提交 |
| 普通内容拒绝 | 内容问题，费用按证据显示 | 修改输入后显式创建新任务 | 把它计为基础设施故障或修改输入规避约束 |
| 提交响应不明确 | 待核对，保留关联 ID | 查询、核对上游证据 | 自动换渠道再次提交 |
| 上游完成但文件不可读 | 结果处理中，保留已成功的上游事实 | 恢复取结果或核对链接 | 再生成视频代替取文件 |
| 未知费用/退款 | 待核实，证据来源明确 | 回填经核对的上游证据 | 显示免费/已退款来掩盖缺失 |
| 编辑版本冲突 | 草稿保留、显示差异 | 选择合并或放弃自己的改动 | 自动换版本重试覆盖 |
一次请求的费用与失败补救
配置一次重试时 A/x 明确失败后才调用 B/x；同请求调用方只计一次，A/B 上游采购分别记录。执行与费用在同一详情，不创建第二条收费请求。Unknown 不等于失败，先核对。
首轮完成应有的体验
管理员能在一个渠道页面完成凭据和型号维护，在一个模型页面看明白如何选路，在一条生成记录里看见实际结果和过程。没有必须回到旧 new-api 才能做的日常操作；没有重复填写参数/价格、为普通操作连续确认、或者用日志代替生成结果的流程。通过条件见 07。
2026-10-14 更新：新渠道优先使用 new-api 视频插件兼容层，保留本页 Go 内核与既有原生能力。此前禁止插件的接入描述由新决定取代；没有部署或切流。