查詢DNA底庫中是否存在相同或者相近的DNA結果。
接口說明
- 本接口可以提交視頻、音頻、圖片和文本 DNA 作業。
- 本接口為異步接口。不保證接口返回時結果已經生成，結果完成后將發送異步消息。
- DNA 相關接口功能，目前開通的地域為華北 2（北京）、華東 2（上海）、華東 1（杭州）、亞太東南 1（新加坡）、沙特（利雅得），其他地域暫不支持。其中，文本 DNA 相關功能，目前僅支持華東 2（上海）地域使用。
- 輸入文件格式限制如下：
- 圖片格式：jpeg、png、bmp。
- 視頻格式：mp4、avi、mkv、mpg、ts、mov、flv、mxf。
- 視頻編碼：MPEG2、MPEG4、H264、HEVC、WMV。
- 文本 DNA 使用場景：底庫僅支持入庫 TextType=Text 的長文本字符串，搜索指定 TextType=ASR 的輸入是 ASR 識別結果，包含 start、end、text 的 JSON 字符串數組。
QPS 限制
本接口的單用戶 QPS 限制為 100 次/秒。超過限制，API 調用會被限流，這可能會影響您的業務，請合理調用。更多信息，請參見 QPS 限制。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| mts:SubmitFpShotJob |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Input | string | 是 | 作業輸入文件地址，支持 OSS 地址、HTTP 地址、視頻點播（VoD）媒資等形式。
說明
OSS 的地域和媒資存儲地域需要與當前 MPS 所在地域保持一致。
| {"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"} |
| PipelineId | string | 否 | 管道 ID，用于綁定消息通知。可通過媒體處理控制臺>全局設置>管道獲取。 | 88c6ca184c0e47098a5b665e2a12**** |
| FpShotConfig | string | 是 | 視頻 DNA 配置，JSON 對象。更多信息，請參見 FpShotConfig 詳情。 | { "PrimaryKey": "12345****", "SaveType": "save", "FpDBId": "417f2ada5999daf****" } |
| UserData | string | 否 | 用戶自定義數據，最大長度 128 個字節，不能以特殊字符開頭。 | testid-**** |
返回參數
異步通知消息參數
| 名稱 | 類型 | 描述 |
|---|---|---|
| Type | String | 消息類型。 |
| FpShotJobNotify | AliyunFpShotJobNotify | 視頻 DNA 作業，參見數據類型 AliyunFpShotJobNotify。 |
| UserData | String | 用戶自定義數據。 |
示例
正常返回示例
JSON格式
{
"RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
"JobId": "2a0697e35a7342859f733a9190c4****"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。