全部產品
Search

搜尋本產品

    ApsaraVideo Media Processing：SubmitFpShotJob

    文件中心

    ApsaraVideo Media Processing：SubmitFpShotJob

    更新時間：Sep 17, 2026

    查詢DNA底庫中是否存在相同或者相近的DNA結果。

    介面說明

    • 本介面可以提交影片、音訊、圖片和文字 DNA 作業。

    • 該介面為非同步介面，提交任務後回傳任務 ID（此時任務尚未完成，任務將進入後台排隊非同步執行），最終結果將透過回呼通知，也可透過查詢 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 位址：OSS 三元組，JSONString。例如：{"Bucket":"test-bucket","Location":"oss-cn-shanghai","Object":"test.mp4"}

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

    • 影片點播（VOD）媒資位址：媒資 ID，JSONString。例如：{"MediaId":"99238***321"}

    說明

    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-****

    返回參數

    名稱

    類型

    描述

    樣本值

    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****"
}

    錯誤碼

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

    變更歷史

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