文档
03 平台04 媒体供应04_开发

MG-04-011 激活接口

Owner: MG-ACTIVATE-01 / Codex Root。内部视频供应管理;独立管理员会话及原有管理 Key;不属于客户平台 API。

GET /admin/v1/activation/{kind}/{id} 只读检查当前数据库条件,返回 data、ETag;kind 为 channels、supplies、models,非视频对象返回 404。data 包含 kind/id/title/version/enabled/ready/checked_at/checks,渠道与规格包含 limit;规格另含 capability、最近 20 条 fixed_supply 测试及 eligible/reason。checks 为 code/label/passed/kind/id/action,可按目标进入处理页面;失败 label 为具体未满足原因。GET 不访问 Provider、不创建任务、不更改状态。

POST 同一路径必须携带 If-Match 当前整数版本。action=enable/disable 分别控制渠道、规格、模型;模型 enable 调用既有发布事务,disable 只关闭调度并保留选用供给和历史。所有写入保留版本与审计,冲突返回 409,条件不满足返回 422;无强制启用参数。

渠道和规格 action=capacity 携带 limit(1..100000)。渠道 action=credential 携带 credential,必须先停用渠道及其供给;加密轮换保留历史版本,在同一事务中清除相关规格启用资格并标记需要以新凭据重新核验。密钥不回显、不写日志。

规格 action=review 携带完整 capability、reference、reviewed=true。必须明确未知的数量/大小/时长限制、提示词与音频能力及真人政策依据。核对生成新规格版本并保持停用,旧结果不能用于新版本。

规格 action=verify 携带 request_id,仅采用该供给当前供给/渠道/规格/凭据版本的持久 fixed_supply 成功测试:唯一成功 Attempt,所有 MP4 结果已封存、SHA/大小一致,主存储已验证且未过期。证据由服务端生成,重复核验幂等,无新任务或付费创建。旧版本、其他供给、路由测试、失败/未知/处理中或未封存媒体均被拒绝。成功核验后仍需单独点击启用。

渠道需要有效凭据、已接入的原生协议和正并发。规格需要渠道启用、完整核对的能力、有效采购规则、当前版本成功交付证据及正并发。模型检查所有选用供给、精确供给、策略与费用币种、已披露/验证的降级规则,最终以原有 canonical 发布事务校验为准。

React /backend/activation/... 通过 Node 管理桥接转发;会话、Origin/CSRF、严格输入和 If-Match 校验保持一致,不向浏览器泄露管理 Key。当前未保存设置、规格表单或版本冲突会阻止运行状态变更。

页面入口:模型目录及调度详情的启用调度;渠道管理的启用渠道/运行管理;视频供给和调度详情每个真实规格的验证与启用;测试记录的核验规格与启用。失败条件提供渠道、规格核对、采购配置、并发、固定测试或调度配置入口。正式测试仍由管理员显式提交,界面显示费用提示;本次部署不执行收费 Provider 调用。