使用SubmitCopyrightExtractJob提交著作權浮水印提取作業-智能媒體服務-阿里雲 - Intelligent Media Services

介面說明

目前數字浮水印相關介面只支援華東 2（上海）、華北 2（北京）地區使用。
該介面為非同步介面，提交任務後返回任務 ID（此時任務尚未完成，任務將進入後台排隊非同步執行），最終結果將通過回調通知，也可通過查詢著作權浮水印提取作業主動查詢任務狀態。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:SubmitCopyrightExtractJob

none

*全部資源

*

無

請求文法

POST  HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
Input	object	是	待提取浮水印的視頻檔案。說明 OSS 檔案/媒資的地區需要與當前 IMS 所在地區保持一致。
Type	string	是	輸入檔案類型，取值： OSS：OSS 檔案地址 Media：媒資 ID	OSS
Media	string	是	輸入檔案資訊，支援 OSS 地址和媒資 ID 兩種。 OSS 地址規則為 1、oss://bucket/object 2、http(s)://bucket.oss-[regionId].aliyuncs.com/object 其中 bucket 為和當前專案處於同一地區的 oss bucket 名稱，object 為檔案路徑。	oss://bucket/object
UserData	string	否	使用者自訂資料，最大長度 1024 位元組。	123
Params	string	否	浮水印任務參數，JSONString。目前支援設定參數如下： algoType：演算法類型，預設值為 v1。提取演算法類型需和嵌入時使用的演算法類型一致。 v1：長視頻著作權提取介面。 v2：短視頻著作權提取介面。	{"algoType":"v2"}

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
Data	object	返回資料
JobId	string	任務 id	bfb786c63****4d80648792021eff90
Message	string	返回資訊	ok
RequestId	string	Id of the request	**2876-6263-4B75-8F2C-CD0F7FCF**
StatusCode	integer	狀態代碼	200

樣本

正常返回樣本

JSON格式

{
  "Data": {
    "JobId": "bfb786c63****4d80648792021eff90"
  },
  "Message": "ok",
  "RequestId": "****2876-6263-4B75-8F2C-CD0F7FCF****",
  "StatusCode": 200
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。