通过调用SubmitTraceAbJob接口提交视频溯源水印ab流任务。
接口说明
-
提交视频溯源水印 ab 流作业目前仅支持 3 分钟及以上视频，视频时间过短会导致接口调用失败或无输出。
-
目前数字水印相关接口只支持华东 2（上海）、华北 2（北京）地域使用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| mts:SubmitTraceAbJob | none |
|
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Input | string | 否 | 溯源水印 ab 流处理视频输入 OSS 地址。OSS 的地域需要与当前 MPS 所在地域保持一致。 说明
提交视频溯源水印 ab 流作业目前仅支持 3 分钟及以上视频，视频时间过短会导致接口调用失败或无输出。
| {"Bucket":"ivison-test","Location":"oss-cn-shanghai","Object":"test.mp4"} |
| Output | string | 是 | 溯源水印 ab 流处理输出 OSS 地址。需要注意的是，配置的是输出目录 Dir。 | {"Bucket":"ivison-test","Location":"oss-cn-shanghai","Dir":"out/"} |
| StartTime | string | 否 | 水印嵌入开始时间。单位：秒。 | 0 |
| TotalTime | string | 否 | 水印嵌入总时间。单位：秒。 | 360 |
| Level | long | 否 | 水印级别，取值 0/1/2，表示嵌入通道，0u，1uv，2yuv。 | 2 |
| CallBack | string | 否 | 任务结果回调 URL，目前仅支持 HTTP 地址。 | http://example.com/callback |
| Url | string | 否 | 可公网访问的视频 URL 链接。填写后优先将其作为任务输入，其次再考虑 Input 输入。 | http://www.example.com/video/test.mp4 |
| UserData | string | 否 | 用户自定义数据，最大长度 1024 个字节。 | 123 |
| CipherBase64ed | string | 否 | base64 后的加密密钥。 | Qh6OdgIMcliQSI1fReOw**** |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "030E2671-806A-52AF-A93C-DA8E308603A6",
"Message": "ok",
"Data": {
"JobId": "bfb786c639894f4d80648792021e****",
"MediaId": "437bd2b516ffda105d07b12a9a82****"
},
"StatusCode": 200
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-07-23 | API 内部配置变更，不影响调用 | 查看变更详情 |