此接口用于指定工作流 ID 来触发媒体处理任务,以对指定片源进行媒体处理。
请求地址:https://vod.volcengineapi.com?Action=StartWorkflow&Version=2020-08-01
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | StartWorkflow | 接口名称。当前 API 的名称为 StartWorkflow 。 |
Version | String | 是 | 2020-08-01 | 接口版本。当前 API 的版本为 2020-08-01 。 |
Vid | String | 否 |
| 视频 ID。音视频上传至视频点播服务后,您可通过媒资上传完成事件获取 注意 您必须设置 |
TemplateId | String | 是 | 63d92a1***b1795 | 工作流 ID。您可在视频点播控制台工作流页面获取 TemplateId 。 |
Input | Object of WorkflowParams | 否 |
| 动态参数。 说明 如果是 POST 请求,该参数类型为 String。示例: |
Priority | Integer | 否 | 0 | 任务优先级。默认值 0。取值范围为 [-5,5]。 |
CallbackArgs | String | 否 | YourCallbackArgs | 您可自定义的字段,回调时会透传返回。在处理回调消息时自己解析使用。最大长度 512 字节。 |
EnableLowPriority | Boolean | 否 |
| 是否开启闲时转码功能。支持的取值如下:
说明 对于闲时转码功能的介绍和使用场景,请见闲时转码。 |
DirectUrl | Object of DirectUrl | 否 |
| DirectUrl 模式下的文件存储信息。 注意
|
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Condition | JSON Map | 否 |
| 任务执行条件和每个节点是否执行完成。格式为
|
OverrideParams | Object of OverrideParams | 否 | - | 覆盖参数,用于覆盖媒体处理模板中的配置。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
FileName | String | 否 | example.mp4 | 文件路径。 |
BucketName | String | 否 | YourBucketName | 存储桶名称。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Logo | Array of LogoOverride | 否 | [{"TemplateId":"1091058d0**6b8f408c352ee1c52","Vars":{"keyword":"hello"}}] | 水印覆盖参数。 |
Snapshot | Array of SnapshotOverride | 否 | [{"Type":["AnimatedPoster"],"OffsetTime":0,"OffsetTimeList":null,"SampleOffsets":null}] | 截图覆盖参数。 |
TranscodeAudio | Array of TranscodeAudioOverride | 否 | [{"TemplateId":["1091058d0**6b8f408c352ee1c52"],"Clip":{"StartTime":0,"EndTime":20000}}] | 音频转码覆盖参数。 |
TranscodeVideo | Array of TranscodeVideoOverride | 否 | [{"TemplateId":["1091058d0**6b8f408c352ee1c52"],"Clip":{"StartTime":0,"EndTime":20000}}] | 视频转码覆盖参数。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Vars | JSON Map | 否 |
| 水印覆盖内容。格式为
|
TemplateId | String | 否 | 1091058d0**6b8f408c352ee1c52 | 水印贴片模板 ID。支持设为 All ,表示对所有水印贴片模板生效。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
FileName | String | 否 |
| 自定义文件路径。变量取值如下:
注意 封装格式为 Dash 时,该参数不生效。 |
FileIndex | String | 否 |
| 自定义截图 index 文件的路径,仅对采样截图生效。取值如下:
|
OffsetTime | Integer | 否 |
| 截图间隔。该参数仅当截图类型为以下时才生效。
|
TemplateId | Array of String | 否 | 1091058d0**6b8f408c352ee1c52 | 模板 ID 列表。支持取值为 All ,表示不区分模板,只要为该类型就生效。 |
SampleOffsets | Array of Float | 否 | [1.0,2.0] | 采样截图时间点。单位为秒。针对 Sample 类型截图模板有效。 |
OffsetTimeList | Array of Integer | 否 | [10,20] | 多动图截图时间。单位为毫秒。针对 Dynpost 类型截图模板有效。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Clip | Object of Clip | 否 | {"StartTime":0,"EndTime":20000} | 裁剪参数。 |
FileName | String | 否 |
| 自定义文件路径。变量取值如下:
注意 封装格式为 Dash 时,该参数不生效。 |
TemplateId | Array of String | 否 | 1091058d0**6b8f408c352ee1c52 | 模板 ID 列表。支持 All 取值,此时不区分模板,只要为该类型就生效。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Clip | Object of Clip | 否 | {"StartTime":0,"EndTime":20000} | 裁剪参数。 |
FileName | String | 否 |
| 自定义文件路径。变量取值如下:
注意 封装格式为 Dash 时,该参数不生效。 |
TemplateId | Array of String | 否 | 1091058d0**6b8f408c352ee1c52 | 媒体处理模板 ID 列表。支持取值为 All ,表示不区分模板,只要为该类型就生效。 |
LogoTemplateId | String | 否 |
| 水印贴片模板 ID。 注意 该参数仅当 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
EndTime | Integer | 否 | 2000 | 裁剪结束时间,单位为毫秒。 |
StartTime | Integer | 否 | 0 | 裁剪开始时间,单位为毫秒。 |
下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
RunId | String | lb:0f557116******059cedf92f1bd | 工作流执行 ID。 |
https://vod.volcengineapi.com?Action=StartWorkflow&Version=2020-08-01&TemplateId=63d92a1***b1795&EnableLowPriority=true&DirectUrl={"FileName":"input_test.mp4"}
{ "ResponseMetadata": { "RequestId": "202208121******514515206772F7C", "Action": "StartWorkflow", "Version": "2020-08-01", "Service": "vod", "Region": "cn-north-1" }, "Result": { "RunId": "lb:0f557116******059cedf92f1bd" } }
下表列举了本接口特有的错误码。如需了解更多错误码,详见视频点播公共错误码。
状态码 | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | InvalidParameter | - | 非法参数。 |
403 | RequestForbidden | - | 请求被禁止。 |
404 | ResourceNotFound | - | ID 找不到。 |
409 | ResourceInUse | - | ID 正在被使用(删除时)。 |
429 | RequestLimitExceeded | - | 请求超过上限。 |
500 | InternalError | - | 内部错误。 |
503 | ServiceUnavailable | - | 服务不可用。 |
点播 OpenAPI 提供了配套的服务端 SDK,支持多种编程语言,帮助您实现快速开发。建议使用服务端 SDK 来调用 API。此 API 各语言调用的示例代码,请参考如下: