全部產品
Search

搜尋本產品

    ApsaraVideo Media Processing：SubmitFpShotJob - 提交DNA作業

    文件中心

    ApsaraVideo Media Processing：SubmitFpShotJob - 提交DNA作業

    更新時間：Feb 25, 2026

    查詢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 地址、ApsaraVideo for VOD（VoD）媒資等形式。

    • OSS 地址：OSS 三元組，JSONString。例如：{"Bucket":"test-bucket","Location":"oss-cn-shanghai","Object":"test.mp4"}

    • HTTP 地址：公網可下載的地址。例如：http://example-test-****.mp4。

    • ApsaraVideo for VOD（VOD）媒資地址：媒資 Id，JSONString。例如：{"MediaId":"99238***321"}

    說明

    OSS 的地區和媒資儲存地區需要與當前 MPS 所在地區保持一致。

    {"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"}
    PipelineId

    string

    否

    管道 ID，用於綁定訊息通知。可通過ApsaraVideo for Media Processing控制台>全域設定>管道擷取。

    88c6ca184c0e47098a5b665e2a12****
    FpShotConfig

    string

    是

    視頻 DNA 配置，JSON 對象。更多資訊，請參見 FpShotConfig 詳情。

    { "PrimaryKey": "12345****", "SaveType": "save", "FpDBId": "417f2ada5999daf****" }
    UserData

    string

    否

    使用者自訂資料，最大長度 128 個位元組，不能以特殊字元開頭。

    testid-****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回參數。

    RequestId

    string

    請求 ID。

    25818875-5F78-4A13-BEF6-D7393642CA58
    JobId

    string

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

    2a0697e35a7342859f733a9190c4****

    非同步通知訊息參數

    名稱類型描述
    TypeString訊息類型。
    FpShotJobNotifyAliyunFpShotJobNotify視頻 DNA 作業，參見資料類型 AliyunFpShotJobNotify。
    UserDataString使用者自訂資料。

    樣本

    正常返回樣本

    JSON格式

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

    錯誤碼

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

    變更歷史

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