使用SubmitAIJob提交智能標籤或視頻DNA作業-ApsaraVideo for VOD-阿里雲 - ApsaraVideo VOD

介面說明

請確保在使用該介面前，已充分瞭解ApsaraVideo for VOD產品的收費方式和價格。智能標籤和視頻 DNA 為付費功能，計費詳情，請參見視頻 AI 計費。
視頻 DNA 支援的服務地區：華北 2（北京）、華東 2（上海）、新加坡；智能標籤支援的服務地區：華北 2（北京）、華東 2（上海）。
該介面為非同步介面，提交 AI 作業任務後返回任務 ID（此時任務尚未完成，任務將進入後台排隊非同步執行），建議配置事件通知功能並指定回調事件為視頻 AI 處理完成以擷取最終處理結果，也可通過擷取任務詳情主動查詢任務狀態。
您需要先開通視頻 DNA 或智能標籤服務後，才能調用此介面提交 AI 作業。開通詳情，請參見視頻 AI。
初次使用視頻 DNA 時，您需提供 uid 及地區資訊，提交工單申請免費開通 DNA 指紋庫，否則將影響後續視頻 DNA 的功能使用。關於如何提交工單，請參見聯絡我們。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

vod:SubmitAIJob

create

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
MediaId	string	否	視頻 ID。可通過以下方式擷取：通過控制台上傳的視頻，可登入點播控制台，選擇媒資庫 > 音/視頻查看視頻 ID。通過擷取視頻上傳地址和憑證介面擷取上傳地址和憑證時，視頻 ID 為返回參數 VideoId 的值。視頻上傳後，可通過搜尋媒體資訊介面查詢視頻 ID，為請求後返回參數 VideoId 的值。	3D3D12340d9401fab46a0b847****
Types	string	否	AI 作業類型。多個作業類型之間用半形逗號（,）分隔。取值： AIMediaDNA：視頻 DNA。 AIVideoTag：智能標籤。	AIVideoTag
Config	string	否	AI 作業配置，JSON 格式。當`Types`設定為`AIVideoTag`時，`Config`支援配置`AnalyseTypes`，設定智能標籤作業分析演算法的類型，取值如下： ASR：語音辨識，從視頻的⾳頻語⾳中識別出標籤。 OCR：圖文識別，從視頻的映像⽂字中識別出標籤。當`Types`設定為`AIMediaDNA`時，`Config`支援配置`DNADBId`，設定 DNA 指紋庫 ID，用於指定視頻 DNA 作業的指紋庫。	{"AIVideoTag": {"AnalyseTypes": "ASR"} }
UserData	string	否	自訂設定，為 JSON 字串。參數結構詳情參考 UserData 。	{"Extend":{"localId":"***","test":"www"}}

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
RequestId	string	請求 ID。	25818875-5F78-4A13-BEF6-D73936****
AIJobList	object
AIJob	array<object>	AI 作業資訊列表。
	object	AI 作業資訊詳情。
Type	string	AI 作業類型。取值： AIMediaDNA：視頻 DNA。 AIVideoTag：智能標籤。	AIVideoTag
JobId	string	AI 作業 ID。	9e82640c85114bf5af23edfaf****
MediaId	string	視頻 ID。	3D3D12340d92c641401fab46a0b847****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "25818875-5F78-4A13-BEF6-D73936****",
  "AIJobList": {
    "AIJob": [
      {
        "Type": "AIVideoTag",
        "JobId": "9e82640c85114bf5af23edfaf****",
        "MediaId": "3D3D12340d92c641401fab46a0b847****"
      }
    ]
  }
}

錯誤碼

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

變更歷史

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