StartExecution 是视频点播面向 AI 媒体处理场景推出的通用异步任务提交入口。该接口通过标准化的请求架构，整合了从基础转码、画质修复到大语言模型视频理解、内容生成等全量媒体处理能力。

任务提交方式指引 #

根据业务的复杂度和参数复用性需求，该接口支持以下三种提交方式：

支持的功能类型 #

按功能属性与实现方式，StartExecution 承载的能力主要分为以下三类：

语义分析与内容理解 #

该类功能主要通过单任务 (Operation.Task) 提交，利用多模态算法将音视频转化为结构化数据，支撑业务决策或内容索引。产物通常为 JSON 或文本。

媒体转换与智能剪辑 #

该类功能支持通过单任务实时配置，或通过单模板任务引用预设模板，对音视频流进行转换、修复或剪辑。产物通常为新的音视频文件（部分任务支持同步输出分析数据）。

AIGC 内容生成 #

该类功能目前通过单任务提交。

执行机制与结果获取 #

StartExecution 接口采用异步执行：

1. 任务提交：调用 StartExecution 接口，任务提交后返回 RunId（任务执行唯一标识）。

2. 异步处理：系统根据任务类型分配算子资源并进入异步队列。

3. 结果获取：

   • 主动查询：调用 GetExecution 接口，通过 RunId 监测 Status。状态为 Success 时，从 Output 字段解析结果。
   • 事件通知：在控制台配置 媒体处理任务执行完成 事件回调。任务结束后，系统向指定地址推送处理结果。

注意事项 #

• 开通白名单：工作流任务、巨量广告预审、ASR 提取字幕、OCR 提取字幕、智能抠图为白名单功能。使用前请提交工单联系火山引擎技术支持团队申请开通。
• 计费说明：任务执行将产生费用。计费维度包含“输入片源时长”或“输出产物时长”，具体参见视频 AI 应用计费。
• QPS 限制：本接口的单用户 QPS 限制为 50 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。