全部產品
Search
文件中心

Intelligent Media Services:SubmitDNAJob - 提交DNA作業

更新時間:Mar 21, 2026

調用SubmitDNAJob提交DNA作業。

介面說明

  • 本介面為非同步介面。不保證介面返回時結果已經產生。

  • 本介面目前支援使用的地區為華北 2(北京)、華東 1(杭州)、華東 2(上海)。

  • 提交文本 DNA 作業目前僅支援華東 2(上海)地區使用。

調試

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

調試

授權資訊

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

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:SubmitDNAJob

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

Input

object

輸入 DNA 檔案。

Type

string

輸入檔案類型,取值:

  1. OSS:OSS 檔案地址

  2. Media:媒資 ID

Media

Media

string

輸入檔案資訊,支援 OSS 地址和媒資 ID 兩種。 OSS 地址規則為:

1、oss://bucket/object

2、http(s)://bucket.oss-[regionId].aliyuncs.com/object

其中 bucket 為和當前專案處於同一地區的 oss bucket 名稱,object 為檔案路徑。

1b1b9cd148034739af413150fded****

PipelineId

string

管道 ID。

5246b8d12a62433ab77845074039****

Config

string

DNA 配置,JSON 對象。 若填寫,會覆蓋模板參數。

{"SaveType": "save","MediaType":"video"}

TemplateId

string

模版 ID。

S00000101-100060

UserData

string

使用者自訂資料,最大長度 128 個位元組。

userData

PrimaryKey

string

唯一的視頻主鍵,唯一性由使用者保證。

3ca84a39a9024f19853b21be9cf9****

DBId

string

DNA 庫 ID。如需建立 DNA 庫,請參見CreateDNADB - 建立 DNA 庫

2288c6ca184c0e47098a5b665e2a12****

DNA 配置 Config 參數包括:SaveType 和 MediaType 欄位。

其中,SaveType 表示儲存類型,包括:

  • nosave: 僅搜尋不入庫。

  • save: 去重入庫。

  • forcesave: 強制入庫。

  • onlysave: 僅入庫不搜尋。

MediaType 表示輸入檔案媒體類型,包括:

  • video: 視頻。

  • audio: 音頻。

  • image: 圖片。

  • text: 長文本。

  • asr: asr 識別文本。

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID。

25818875-5F78-4A13-BEF6-D7393642CA58

JobId

string

視頻 DNA 作業 ID。建議您儲存此 ID 便於後續調用其他相關介面時使用。

88c6ca184c0e47098a5b665e2****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "JobId": "88c6ca184c0e47098a5b665e2****"
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情