文档
03 平台04 媒体供应03_设计

MG-03-007 内部视频服务

当前以 CURRENT_BOUNDARY 为准;本页描述保留的内部视频实现。 跨仓任务、身份和费用缺口见 接入核对。

边界

新平台 Core 负责客户鉴权、Key、销售目录、客户价格、预留与结算;new-api 为统一供应入口。 既有 uumi 对接客户业务单列,不由本次合并迁移。本服务不提供 这些 API 或页面。只接受内部服务调用与内部运维访问;默认 Compose 端口绑定环回地址, 公网发布、匿名访问和流量切换不在本轮范围。

本地运行使用真实 PostgreSQL、Redis、MinIO 与同源管理页面,无 Fake Provider。 仅 development 环境并显式绑定回环 HTTP 地址时,允许 HTTPS localhost/回环 IP 的 结果服务基址;本地 TLS 证书不自动安装到系统信任库。生产校验、外部素材下载的 SSRF 规则及内容重定向白名单不放宽。服务启动不自动启用供给、发布模型或执行生成测试。

内部身份与兼容

  • 调用密钥和管理密钥分别由部署环境提供,至少 32 字符且不能相同;只保存哈希用于比较。
  • 调用密钥只能访问视频创建/查询/结果;管理密钥能访问运营界面和管理 API。
  • 浏览器以手动输入的管理密钥建立仅内存访问状态,不保存完整密钥到 local/sessionStorage, 不使用旧用户登录 Session;页面刷新需要重新输入。Bearer 请求不携带 Cookie 鉴权。
  • 为兼容历史请求、对象资产和持久 Permit 外键,数据库保留既有表,并使用专用内部归属行。 归属行不允许密码登录,不是可管理/可售卖用户;新请求不依赖客户组授权或客户价格。
  • 旧用户和售价表不做破坏性删除;旧用户/客户组/Key/售价操作及广场从运行时路由移除。

视频入口和模型

  • 保留 POST /v1/videos、GET /v1/videos/{id}、结果内容入口,以及 ModelArk 创建/查询。
  • GET /v1/models 仅返回已发布视频模型的标准 ID/明确别名,不返回广场、售价或上游信息。
  • 标准入口包括 seedance-2.0、seedance-2.0-fast、seedance-2.0-mini、seedance-2.5。
  • 允许运维显式创建独立供给别名,例如 sd2.5-e-commerce;名称只用于内部路由,新平台售卖仍 由 Core 完成。别名只绑定指定供给,不自动扩展为同系列的其他供给。
  • 公共请求校验同时使用模型配置和实际供给能力;2.5 可声明更长时长/更多素材,但不改变 2.0 基线或绕过 Provider 文档约束。未发布、未知名称或不支持的参数在提交前失败。
  • 图像 API、图像后台入口不挂载;既有图像模块及历史数据保留,不开展图像迁移/测试。

视频供给路由

渠道与模型供给是父子关系,不是平级配置:每个 Supply 只归属一个 Channel。 视频渠道列表仅展示父级渠道及供给数量;进入 /admin/video/channels/{channel_id} 后, 才管理该渠道的连接、凭据、发现和子供给。供给导入固定使用当前父渠道,不能跨渠道 选择或搬移;返回渠道列表后才进入其他渠道。不存在/非视频渠道不能回退显示全局供给。 此项只调整管理页面,不复制配置、不改动供给外键、调度语义或现有管理 API。

渠道移除见 D-023:归档父渠道与停用全部子供给同事务,保留全部引用和历史执行资料; 已创建 Attempt 继续完成。默认列表隐藏归档项,已移除列表支持恢复为停用,不自动恢复供给 生产状态。移除/恢复都检查版本并持久审计,归档父渠道不能导入或重新启用子供给。

管理入口名称固定为“视频供给路由”。以标准模型/独立别名和上游供给为两个视角。 渠道只维护连接、凭据、容量和健康;Supply 维护具体型号、请求 Profile、分辨率/时长/ 素材/音频/真人能力、Provider 成本和真实测试证据。Binding 只保存参与状态与角色。 继续使用 stable_first/cost_first、exact/fallback/degraded 和最多一次换供给,不引入 旧数字优先级/权重。成本不是售价,不跨未验证币种自动比较。

迁移与一次性验证

从 pic-vps/new-api-oceanway-app 对应 PostgreSQL 在只读一致快照内提取视频配置。 使用字段白名单,忽略用户、分组、售价、优先级和权重。新配置默认 disabled/unpublished。 旧独立别名必须保留,分辨率指向不同型号时拆为不同 Supply。成本与能力保留为待核验事实。 秘密通过受限临时流进入目标信封加密,不进入清单、Git、终端或错误正文。

每个源启用视频渠道最多一次最短时长文生视频 POST。先持久占用测试预算再提交,即使 超时/失败也不能重提;Poll 可继续。停用渠道不生成。缺文档/参数无法构造合法请求时报告 阻塞,不能猜测;失败不能被当作成功或通过重试掩盖。一次成功只验证该请求,不自动 把全部型号启用。现网始终只读,不部署、不切流。

2026-10-14 更新:新渠道优先使用 new-api 视频插件兼容层,保留本页 Go 内核与既有原生能力。此前禁止插件的接入描述由新决定取代;没有部署或切流。

On this page