MG-02-003 领域与配置
状态：产品范围、普通配置无二次确认、单管理员、历史保留及 D08 渠道编辑布局已确认；具体字段/存储映射为建议稿。这里的名称是产品与接口的逻辑模型；不要求新建一套与现有 Supply 并行的路由数据库。具体存储映射在实现前单独设计并检查历史引用。
图片模型渠道管理（2026-10-14 已确认）
用户确认图片模型渠道管理直接与 new-api 原生管理保持一致。后续图片渠道页面的管理流程、字段组织和常用操作优先复用 new-api 原生实现；具体字段与本仓接口/存储映射在实现任务中核对固定版本源码。下文视频型号组、规格行、复杂参数侧边编辑的设计适用于视频，不作为图片渠道管理的默认要求。
图片渠道配置接入本网关独立管理员会话、版本化加密凭据和现有配置存储；图片协议执行沿用已有 OpenAI/Gemini 原生适配能力。渠道管理的一致性不扩展为客户账户、钱包、销售价格或旧路由数据库领域的移植，也不要求运行 new-api 平台。
既有渠道盘点和两次 Provider 直连证据见 MG-IMAGE-01。图片管理、运行接口、记录/采购成本和结果保存的完整接入仍待实现与验收。本次只记录设计决定，不改变运行配置、启用状态或付费测试范围。
2026-10-15 后续确认与实现
图片已调整为“每个 new-api Key 一条独立渠道；同一标准型号绑定多个渠道”，支持顺序/成本优先、版本化采购成本、型号并发与 Key 总并发。继续复用原生 Supply、Binding、图片能力/成本版本及全局容量租约，不另建路由数据库。管理端支持按上游和按模型切换视图，同一API上游的多个Key归组；视图只读派生，不合并真实渠道或改动调度顺序。已实现与验证见 MG-IMAGE-06、MG-IMAGE-07，接口见 图片调度。前述“尚待接入”保留其当时背景，当前公共执行、真实供给验收与原生异步仍单列。
对象关系与统一名称
| 对象 | 定义与职责 | 不属于它的字段 |
|---|---|---|
| 渠道 Channel | 一家上游的连接、认证、协议、渠道级限流及健康；可有多个型号 | 标准模型的排序、客户售价 |
| 凭据版本 | 信封加密的供应认证，版本化及审计；在途执行保留可用版本引用 | 表单回读中的原文密钥 |
| 上游型号组 | 渠道下便于维护的型号与共享参数；是 UI 分组，可映射已有 family 标识 | 另一套运行时选路实体 |
| 规格供给 Supply | 能用确定的上游型号、规格和协议执行请求的最小供给；唯一所属渠道 | 多渠道共享凭据、客户销售 SKU |
| 能力/成本版本 | 参数范围、协议映射、计价与来源的一致快照 | 与运行报价分离且需人工同步的副本 |
| 标准模型 | 调用方可用的稳定 ID 与请求契约；可绑定多家供给 | Provider 密钥和采购报价编辑入口 |
| 独立别名 | 只绑定指定供给集合的 API ID | 自动扩展到同系列的所有供给 |
| 路由参与项 | 标准模型到 Supply 的引用、参与状态、人工顺序/角色 | 上游原始型号、参数、价格副本 |
| 验证证据 | 哪一版本、规格、请求及结果通过何种验证 | “整个渠道已成功一次所以全启用” |
| Request / Task / Attempt | 用户请求、持久执行生命周期、一次实际供给提交 | 三张重复的“使用记录”列表 |
同一型号在 480p/720p 使用不同原始型号时，UI 展示为一组规格行，执行仍解析到唯一 Supply 与配置版本。同名不能证明等价；没有 family 来源的旧供给用明确映射整理，不能靠删除字符串猜测归组。
字段只维护一次
| 位置 | 常用字段 | 高级/条件字段 |
|---|---|---|
| 渠道连接 | 名称、适配器、Base URL、凭据、启停 | 协议规定的提交/查询路径覆盖、渠道容量、非敏感备注 |
| 型号共享参数 | 显示名、协议 Profile、提示词要求、时长、比例、素材/音频模式 | seed、提示词增强、真人限制、各类素材最小/最大数量 |
| 规格行 | 分辨率、原始 upstream model、上游分辨率、采购计价单位、单价/固定价、币种 | 参考视频费用、音频附加、最低计费时长、分档价、失败计费规则 |
| 模型与调度 | 标准 ID、对外参数契约、引用供给、顺序/策略、启停 | 重试次数 0/1、队列时限、明确运维成本限制，不追加客户重试费 |
| 设置 | 运行版本、对象存储状态、单管理员密码/会话、服务认证及历史保留状态 | 高级运维参数；运行密钥不在 UI 明文展示 |
D08 已确认规格表直接编辑、复杂参数侧边编辑。规格行的上游型号、分辨率映射和常用采购价格在表中维护；共享时长/比例/素材等规则在型号组侧边区维护。分档价、附加费等无法用单价表达的规则也在侧边区编辑，表格展示计算摘要，不再复制一份“执行价格”。具体交互见 05 渠道编辑。
型号组默认规则与规格例外必须显式区分。规格未覆盖的字段引用组默认；确有差异时标明覆盖字段及适用规格，解析到 Supply 的有效配置仍只有一个版本。修改组默认前展示受影响规格，不能悄悄覆盖既有例外或把其他分辨率的能力当作已验证。
读取来的原始报价可以作为只读来源资料保留；生效成本只能有一个规范化版本。界面展示“采购原文 → 规范化执行规则 → 示例请求成本”，不能让管理员在采购资料页和执行成本页分别维护同一数字。
参数模型与来源
时长支持枚举或闭区间，比例和分辨率使用明确枚举。素材包括参考图、首尾帧、参考视频、参考音频，支持数量、大小、格式及可信时长限制；音频模式明确为不支持、可选默认关、可选默认开或强制。预设代码 933/900/431/903/910/000 只作为旧来源兼容值，页面优先显示实际素材规则。
预设是填表工具，不是验证结论。不同协议支持同样素材名称也可能使用不同请求字段；adapter 转换负责差异，公共标准请求不用填上游私有字段。服务端校验与 UI 校验共享同一有效能力投影，不能只靠前端限制。
每项能力或价格至少记录：来源类型（目录/文档/人工/测试）、来源定位、获取时间、维护者、核验状态。上游目录可能只列名称：不能因此推断参数、价格或真实可用性。目录/报价“已读取”、静态参数“完整”、真实请求“已验证”分别展示。
目录同步生成差异：新增、资料改变、上游未再返回、人工冲突。默认不覆盖人工值；将差异应用到选中的型号/字段；缺失目录项标记待核对，不自动归档。网络失败保留上次已知配置与时间，不能把空响应当作全量删除。发现操作不在请求执行路径逐次调用。
状态与验证范围
不要用一个绿点表示所有状态。渠道连接、配置完整性、规格验证、运行启用和临时健康分别展示；列表可提供“可用/待验证/停用/异常”摘要，并能展开原因。
- 渠道：启用或停用、是否归档；连接检查及健康另列。
- Supply：草稿/待验证/已验证的配置资格，加上启用/停用；容量/健康是临时运行状态。
- 标准模型：当前生效版本、是否对调用方开放；未启用时可保存完整草稿。
- 验证证据：绑定 adapter/Profile、上游型号、能力、凭据等有关版本指纹和被测规格/场景。价格真实性独立核对。
- 配置版本：有效或被替代；在途任务始终引用接受时固定的执行版本及凭据。
单次最短文生视频只覆盖该请求场景，不能证明参考视频、首尾帧、真人、音频和全部分辨率都可用。首次启用门禁按供给实际开放能力要求对应证据；存在未核实能力时先缩小开放契约，不能假装已验证。连接和发现成功只证明读取链路。
保存与生效
每个当前编辑范围只有一份草稿和一个明确的保存主按钮，后端完成一个原子配置提交。渠道连接单独编辑保存；同一渠道的型号/规格表与参数侧边区属于同一编辑范围，不各自保存或发布。不能前端连续 PATCH 若干端点后把部分成功当“保存完成”。目标是聚合现有 repository 操作，复用字段规则，而不是新增平行存储。
| 修改 | 主按钮与生效 | 验证/在途影响 |
|---|---|---|
| 名称、显示顺序、备注 | 保存；当前启用状态保持 | 不失效执行证据，在途不变 |
| 草稿的参数/价格/映射 | 保存；留在停用草稿，显示缺失项 | 不自动启用 |
| 生效供给的已核对价格 | 保存并生效；以完整新成本版本原子提交 | 从后续接受任务起适用；价格不明则不能生效，已有任务报价不改 |
| 协议/Profile、地址、凭据或原始型号改变 | 表单先列出影响；保存并暂停受影响供给 | 相关执行证据失效；轮询/取结果仍用旧执行快照 |
| 生效能力扩展/语义改变 | 保存并暂停受影响规格；重新验证 | 不改历史和在途能力；纯缩小限制也需校验现有绑定契约 |
| 模型参与项、人工顺序、有效策略改变 | 停用模型“保存”；启用模型“保存并生效” | 校验通过才切有效版本；不因编辑整体停服，不改已接受任务 |
| 验证通过后的启用 | 单次“启用”，缺失门禁就列出原因 | 只启用被核验范围，不连带其他规格 |
价格“已核对”要有来源与维护记录；没有足够依据的价格可以存草稿，但不能借一次普通保存升级为已核对。D02 已确认调用方只计一次，上游费用分别记；不把采购资料变成追加客户重试费的配置。一处价格/一次保存，无二次确认。
同一渠道的型号/规格编辑一次保存本页草稿中的全部变更；原子范围为这些发生变化的型号组、规格及其必要关联，价格、能力、版本及关联调整同事务。未修改对象不无故生成新版本，渠道连接不混入本次提交。表格和侧边区只是同一草稿的两个编辑位置，关闭侧边区不提交也不丢修改。跨渠道批量操作返回逐项明确结果，不宣称跨 Provider 全局事务。每次修改传当前版本（沿用 If-Match 语义）；冲突返回服务端当前版本和安全差异，草稿保留，禁止自动覆盖重试。
表单可以保存未完成草稿，但“保存并生效/启用”必须满足完整性、能力契约、已知成本、相关验证和未归档条件。保存失败时有效配置完全保持，所有未保存字段留在草稿；字段错误定位对应行/侧边字段，版本冲突也不丢失其他型号的修改。编辑时不要先把有效模型关闭，再期待另一页“发布”恢复。
凭据和归档
首轮只有一个独立管理员；旧用户标识是历史来源，不恢复登录。历史实体/引用永久保留。
同一渠道的规格引用渠道凭据，不逐个复制密钥。凭据更新创建新加密版本；掩码不能作为新密钥再写回。连接调用发生在事务外，读取配置快照并回写带版本的证据，避免旧检查覆盖新配置状态。
轮询与结果读取需要旧凭据时保留相应版本；Provider 若已撤销旧密钥则明确进入恢复问题，不能承诺保留引用就一定可调用。凭据撤销计划应列出在途任务影响，不记录真实密钥。
归档渠道与停用供给同事务，保留历史 FK、任务、结果及审计；恢复保持停用。仅当没有任何引用且独立授权数据清理时才考虑硬删除，日常维护不提供此入口。恢复或归档不产生新的生成请求。