文档
02 决策(ADR)

ADR-0003 媒体供应路线

背景

媒体供应的路线多次反复:9-30 定为摆脱 new-api,10-14 又改为复用 new-api 插件;文档站则写 media-gateway "不是当前新主链",而该仓库仍在密集开发。

决策

  1. new-api-new-oceanway 定为遗留平台:继续承担当前线上图片/视频供应,只做维护和必要修复,不再扩展新能力。
  2. oceanway-media-gateway 定为目标主链:作为后续图片/视频供应的唯一投入方向,开发完成并通过切换验收后,替换 new-api-new-oceanway。
  3. 过渡期:切换之前,遗留平台持续服务,Platform 仍通过现有适配器调用它;切换按渠道或能力分批进行,每批都要有回滚方案。
  4. media-gateway 是否兼容 new-api 插件机制,属于 media-gateway 内部的实现选择,不影响本决策;如需调整另开 ADR。

切换条件(2026-10-16 zao 确认)

  • 现有线上渠道和模型在 media-gateway 上的功能与价格对齐。
  • 在途任务、结果存储和计费对账都经过验证。
  • 有灰度和回滚方案,并经 zao 确认。

后果

  • 新渠道和新功能只在 media-gateway 开发。
  • 文档:03_平台/04_媒体供应以 media-gateway 为主;new-api 的说明标为 Deprecated,切换后归档。
  • 删除 media-gateway README 顶部的日期式决策段落,改为链接本 ADR。

On this page