調用SubmitCopyrightJob提交視頻版權水印任務。
使用說明
- 提交視頻版權水印作業目前僅支持3分鐘及以上視頻,視頻時間過短會導致接口調用失敗或無輸出。
- 提交視頻版權水印作業每次接口的調用,都是對獨立視頻進行添加水印,不支持多個視頻同時提交。
- 目前數字水印相關接口只支持華東2(上海)地域使用。
QPS限制
本接口的單用戶QPS限制為100次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。更多信息,請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求頭
該接口使用公共請求頭,無特殊請求頭。請參見公共請求參數文檔。
請求語法
POST /submitCopyrightJob HTTP/1.1
請求參數
名稱 | 類型 | 位置 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|---|
Object | Body | 是 | 請求參數。 |
||
CallBack | String | Body | 否 | http://example.com/callback | 任務結果回調URL。 |
Description | String | Body | 否 | 地址 : 上海市浦東新區上科路川和路 | 水印信息描述。 |
Input | String | Body | 否 | {"Bucket":"example-bucket","Location":"oss-cn-shanghai","Object":"example.flv"} | 待添加水印的媒體文件OSS地址,目前僅支持視頻文件,JSON對象。詳細信息請參見Input詳情。 說明 提交視頻版權水印作業目前僅支持3分鐘及以上視頻,視頻時間過短會導致接口調用失敗或無輸出。
|
Level | Long | Body | 否 | 2 | 水印強度,整數,取值范圍[0,2]。 |
Message | String | Body | 是 | 平頭哥半導體公司 | 水印信息。 |
StartTime | Long | Body | 否 | 100 | 水印起始時間,單位為秒,不填寫默認為0。 |
TotalTime | Long | Body | 否 | 1000 | 水印結束時間,單位為秒,不填寫默認為0。 |
Output | String | Body | 是 | {"Bucket":"example-bucket","Location":"oss-cn-shanghai","Object":"example.flv"} | 文件輸出OSS地址。 說明 OSS的地域需要與當前MPS所在地域保持一致。 |
UserData | String | Body | 否 | 123 | 用戶自定義數據,最大長度1024字節。 |
Url | String | Body | 否 | http://www.example.com/video/test.mp4 | 視頻URL鏈接。 |
VisibleMessage | String | Body | 否 | abcd | 可見水印。 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
RequestID | String | 610399D2334334AE2CB70C28 | 請求ID。 |
Message | String | ok | 返回信息。 |
Data | Object | 返回數據。 |
|
JobId | String | bfb786c639894f4d80648792021e**** | 任務ID。 |
StatusCode | Long | 200 | 狀態碼。 |
示例
請求示例
POST /submitCopyrightJob HTTP/1.1
Host:mts.aliyuncs.com
Content-Type:application/json
{
"CallBack" : "http://example.com/callback",
"Description" : "地址 : 上海市浦東新區上科路川和路",
"Input" : "{\"Bucket\":\"example-bucket\",\"Location\":\"oss-cn-shanghai\",\"Object\":\"example.flv\"}",
"Level" : 2,
"Message" : "平頭哥半導體公司",
"StartTime" : 100,
"TotalTime" : 1000,
"Output" : "{\"Bucket\":\"example-bucket\",\"Location\":\"oss-cn-shanghai\",\"Object\":\"example.flv\"}",
"UserData" : "123",
"Url" : "http://www.example.com/video/test.mp4",
"VisibleMessage" : "abcd"
}
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<SubmitCopyrightJobResponse>
<RequestID>610399D2334334AE2CB70C28</RequestID>
<Message>ok</Message>
<Data>
<JobId>bfb786c639894f4d80648792021e****</JobId>
</Data>
<StatusCode>200</StatusCode>
</SubmitCopyrightJobResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestID" : "610399D2334334AE2CB70C28",
"Message" : "ok",
"Data" : {
"JobId" : "bfb786c639894f4d80648792021e****"
},
"StatusCode" : 200
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。