調用SubmitTraceAb提交視頻溯源水印ab流任務。
使用說明
- 提交視頻溯源水印ab流作業目前僅支持3分鐘及以上視頻,視頻時間過短會導致接口調用失敗或無輸出。
- 目前數字水印相關接口只支持華東2(上海)地域使用。
QPS限制
本接口的單用戶QPS限制為100次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。更多信息,請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求頭
該接口使用公共請求頭,無特殊請求頭。請參見公共請求參數文檔。
請求語法
POST /submitTraceAb HTTP/1.1
請求參數
名稱 | 類型 | 位置 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|---|
Object | Body | 否 | 請求參數。 |
||
CallBack | String | Body | 否 | http://example.com/callback | 任務結果回調。 |
Input | String | Body | 否 | {"Bucket":"ivison-test","Location":"oss-cn-shanghai","Object":"test.mp4"} | 溯源水印ab流處理視頻輸入OSS地址。OSS的地域需要與當前MPS所在地域保持一致。 說明 提交視頻溯源水印ab流作業目前僅支持3分鐘及以上視頻,視頻時間過短會導致接口調用失敗或無輸出。 |
Level | Long | Body | 是 | 2 | 水印強度,可選值0,1,2。 |
Output | String | Body | 是 | {"Bucket":"ivison-test","Location":"oss-cn-shanghai","Dir":"out/"} | 溯源水印ab流處理輸出OSS地址。 說明 OSS的地域需要與當前MPS所在地域保持一致。 |
UserData | String | Body | 否 | {uid:1765****} | 用戶自定義數據,最大長度1024個字節。 |
Url | String | Body | 否 | http://example.com/image_01.jpg | 文件地址。 |
StartTime | Long | Body | 否 | 0 | 水印嵌入開始時間。單位:秒。 |
TotalTime | Long | Body | 否 | 360 | 水印嵌入總時間。單位:秒。 |
CipherBase64ed | String | Body | 否 | Qh6OdgIMcliQSI1fReOw**** | base64后的加密密鑰。 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
Data | Object | 返回數據。 |
|
JobId | String | bfb786c639894f4d80648792021e**** | 任務ID。 |
MediaId | String | 437bd2b516ffda105d07b12a9a82**** | 媒體ID。 |
Message | String | ok | 返回信息。 |
RequestID | String | 610399D2334334AE2CB70C28 | 請求ID。 |
StatusCode | Long | 200 | 狀態碼。 |
示例
請求示例
POST /submitTraceAb HTTP/1.1
Host:mts.aliyuncs.com
Content-Type:application/json
{
"CallBack" : "http://example.com/callback",
"Input" : "{\"Bucket\":\"ivison-test\",\"Location\":\"oss-cn-shanghai\",\"Object\":\"test.mp4\"}",
"Level" : 2,
"Output" : "{\"Bucket\":\"ivison-test\",\"Location\":\"oss-cn-shanghai\",\"Dir\":\"out/\"}",
"UserData" : "{uid:1765****}",
"Url" : "http://example.com/image_01.jpg",
"StartTime" : 0,
"TotalTime" : 360,
"CipherBase64ed" : "Qh6OdgIMcliQSI1fReOw****"
}
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<SubmitTraceAbResponse>
<Data>
<JobId>bfb786c639894f4d80648792021e****</JobId>
<MediaId>437bd2b516ffda105d07b12a9a82****</MediaId>
</Data>
<Message>ok</Message>
<RequestID>610399D2334334AE2CB70C28</RequestID>
<StatusCode>200</StatusCode>
</SubmitTraceAbResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Data" : {
"JobId" : "bfb786c639894f4d80648792021e****",
"MediaId" : "437bd2b516ffda105d07b12a9a82****"
},
"Message" : "ok",
"RequestID" : "610399D2334334AE2CB70C28",
"StatusCode" : 200
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。