提交视频溯源水印m3u8文件任务。
接口说明
-
使用本接口前需先调用提交视频溯源水印 ab 流，获取到 ab 流处理后的媒体 ID，再调用本接口进行处理。
-
目前数字水印相关接口只支持华东 2（上海）、华北 2（北京）地域使用。
-
该接口为异步接口，提交任务后返回任务 ID（此时任务尚未完成，任务将进入后台排队异步执行），最终结果将通过回调通知，也可通过查询视频溯源水印 m3u8 作业列表主动查询任务状态。
-
经过视频溯源水印 m3u8 作业处理生成的 m3u8 文件签名鉴权有效期为 24 小时（从处理完成开始计时），请尽快查询，签名鉴权过期后将无法查询到该次作业的水印信息。如签名鉴权过期后需要，请重新提交视频溯源水印 m3u8 作业。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ice:SubmitTraceM3u8Job |
none |
*全部资源
|
无 | 无 |
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| TraceMediaId |
string |
是 |
溯源水印 ab 流处理后的媒体 Id，可以从提交视频溯源水印 ab 流的返回参数中获取。 |
437bd2b516ffda105d07b12a9a82**** |
| Output |
object |
是 |
m3u8 文件输出 OSS 地址。 说明
OSS 的地域需要与当前 MPS 所在地域保持一致。 |
|
| Type |
string |
是 |
输出文件类型，取值：
|
OSS |
| Media |
string |
是 |
输出文件信息，支持 OSS 地址。 OSS 地址规则为： 1、oss://bucket/object 2、http(s)://bucket.oss-[regionId].aliyuncs.com/object 其中 bucket 为和当前项目处于同一区域的 oss bucket 名称，object 为文件路径。 |
oss://bucket/object |
| Trace |
string |
是 |
溯源水印信息。 |
溯源水印测试 |
| KeyUri |
string |
否 |
密钥服务器 uri。 |
https://cipher.abc.com |
| Params |
string |
否 |
水印任务参数，JSONString。目前支持设置参数如下：
|
{"m3u8Type":"v1"} |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| Data |
object |
返回数据。 |
|
| JobId |
string |
任务 id。 |
bfb786c639894f4d8064879202**** |
| Message |
string |
返回信息。 |
ok |
| RequestId |
string |
Id of the request |
******11-DB8D-4A9A-875B-275798****** |
示例
正常返回示例
JSON格式
{
"Data": {
"JobId": "bfb786c639894f4d8064879202****"
},
"Message": "ok",
"RequestId": "******11-DB8D-4A9A-875B-275798******"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。