ADR-0012 API Key模型开放与文本媒体协议

来源：原 overview/decisions.mdx（已归档至 08_归档/02_重构前文档），按主题整理，原文保留；验收证据与进度段落已移至 PROC-02-002。

决策摘要

客户 Key 无分组、可调用全部开放模型；文本每模型单渠道；媒体能力与计量单位分离；Key 复制直接取回完整 Key。

原决定

2026-10-02 原生分组职责拆分

用户指出new-api将多种分组职责混入同一概念，源码确认会影响当前模型报价、充值优惠及后续订阅。登记 D-GROUP-DOMAINS-SEPARATE：平台客户分类、平台/产品角色、消费价格方案、销售许可、充值/订阅权益、网关路由及服务策略须独立管理；保留原生计费计算与配置基础，不沿用原生group共同命名空间作为价格和授权权威。改客户分类、Key策略或供应选路不能暗改同一销售规格的合同价，订阅购买/到期不能覆盖企业合同或员工权限。此为现行改造约束，未实现；完整边界与迁移验收见钱包与计费。

2026-10-03 用户组与Key组（Key组部分已被替代）

用户明确这是本期必须完成的内容，补充D-GROUP-DOMAINS-SEPARATE：用户组与Key组采用独立定义、引用、管理入口、绑定授权及审计，不以同名或空Key组继承用户组维持原生耦合。登记一期P0 PL-018与AC-13，关联T-04～T-09；一期全为个人用户，企业方案二期的决定不影响这项交付。计价、充值、订阅与迁移规则见钱包与计费。本次确认需求，尚未完成代码或业务验收。

2026-10-05 一个客户Key调用全部开放模型

2026-10-05用户确认：客户API Key没有分组，也不配置逐Key模型白名单；每个有效Key均可调用平台全部已上架、已开放且有有效价格的模型。同一模型/规格使用相同个人标准销售价，按实际用量结算。账户状态、Key归属/启停/额度/有效期、钱包与必要调用限制仍校验；用户组只作账户归属管理，不筛选个人用户的模型或售价。上游Key由后台按模型接入配置选择，供应渠道及采购价格留在uumi（文本）或媒体网关（视频）。未验收能力不开放。

D-KEY-ALL-MODELS替代2026-10-03的Key组/获准关系/绑定及分组模型许可要求。PL-003与PL-018、AC-03/13、UI-C05与UI-A07/A08及T-04～T-09同步调整；旧组和模型限制数据的兼容处理、契约与代码改造仍待实现验证，不以历史组测试证明新行为通过，原账务与价格快照保留。

2026-10-06 模型价格与销售版本（文本多版本部分已被替代）

D-MODEL-SALES-PRICE：用户确认所有已开放模型默认对全部用户可用，当前订阅不解锁模型。保留独立模型价格页用于透明展示各模型价格；探索模型负责能力、示例和接入，充值与订阅负责资金购买。文本、视频、图像、音频按实际类型/计量及规格展示标准售价；Claude的Kiro、官方Key等不同售价作为明确销售版本并使用不同精确API模型名，不让隐藏供给切换暗改价格。管理员配置类型、系列、版本、公开列价与原生规格规则，保存后核对客户回读；仅列价不扩大媒体调用能力。关联PL-010.R01、PL-006.R01～02、PL-011.R08～12，T-07/08/09；媒体实际生成仍按G-07逐组合验收。

2026-10-07 文本单渠道与媒体内部协议

D-TEXT-SINGLE-CHANNEL-MEDIA-PROTOCOL：用户暂停此前文本同名多渠道及版本选择讨论，当前每个文本模型只提供一个渠道，避免在标准协议中新增版本选择。此前讨论的请求头、模型别名、多个入口及账户/Key调用偏好均不实施；具名上游接入配置仍可用于不同文本模型，不恢复客户Key分组。

图片和视频可以使用平台内部自定义协议。图片生成/编辑、视频生成、任务查询是能力或动作；按次、按张、按秒、按token是计量单位，不能互相代替。适用规则及规格由管理员发布，客户选择已发布规格，实际计量由后端从可信结果核对；token计量不意味着该模型是文本模型。管理员配置与客户估价/价格展示复用同一价格版本和单位，原操作快照及未知只查原任务保持。自定义客户端契约不改变上游供给边界：视频仍经媒体网关，图片仍待审计，不授权直接供应调用。关联PL-004.R01、PL-006.R01～02、PL-011.R08/R10、PL-013/014与T-06/07/08；具体媒体契约及执行验收仍属G-07，本次仅同步决定。