裁剪、拼接、字幕和封面等编辑能力跨越上传、任务编排、处理引擎与发布服务。稳定实现依赖一份清晰的任务协议。
参数描述意图
协议应表达时间线、素材引用、变换和输出要求,而不是把某条命令行直接暴露给上层。执行引擎可以升级,业务意图保持稳定。
创建任务即返回标识
媒体处理天然异步。创建接口完成校验和幂等落库后返回任务标识;调用方通过查询或回调获取状态,不持有长连接等待处理结束。
状态机
Created → Running → Succeeded
└→ Failed / Cancelled
失败结果包含阶段、可重试性和安全摘要,不能只返回一段执行日志。
上线顺序
先上线能够兼容新字段的消费者,再开放生产者发送新协议;最后启用产品入口。回滚时反向关闭入口和生产者,避免旧消费者收到无法识别的任务。
跨服务功能的上线顺序本身就是协议设计的一部分。