全部產品
Search

搜尋本產品

    ：GetDigitalWatermarkExtractResult - 查詢數字浮水印提取作業

    文件中心

    ：GetDigitalWatermarkExtractResult - 查詢數字浮水印提取作業

    更新時間：Dec 15, 2025

    通過調用本介面查詢數字浮水印（著作權浮水印或溯源浮水印）的提取作業結果，包括數字浮水印提取作業的狀態、成功提取出的浮水印文字等資訊。

    介面說明

    • 目前本介面服務地址僅支援：華東 2（上海）、華北 2（北京）。

    • 調用 SubmitDigitalWatermarkExtractJob 介面提取視頻的著作權浮水印或溯源浮水印後，調用本介面查詢提取出來的浮水印文字資訊。

    • 目前僅支援查詢最近 2 年內的浮水印提取作業。

    調試

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

    調試

    授權資訊

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

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

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:GetDigitalWatermarkExtractResult

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    MediaId

    string

    是

    待查詢的視頻 ID，僅支援傳入單個視頻 ID。可通過以下方式擷取：

    93ab850b4f6f54b6e91d24d81d4****
    ExtractType

    string

    是

    浮水印提取類型。取值：

    • TraceMark：溯源浮水印

    • CopyrightMark：著作權浮水印

    TraceMark
    JobId

    string

    否

    浮水印提取作業 ID。

    • 調用 SubmitDigitalWatermarkExtractJob 介面後會返回。

    • 傳入該參數，則可查詢指定浮水印提取作業 ID 的結果；不傳，則預設返回該視頻下所有歷史浮水印提取作業的結果。

    2bf4390af9e5491c09cc720ad****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

    42E0554B-80F4-4921-****-ACFB22CAAAD0
    AiExtractResultList

    array<object>

    浮水印提取作業詳情。

    object

    JobId

    string

    浮水印提取作業 ID。

    3af004763bcf459698860f4ede20****
    CreateTime

    string

    浮水印提取作業的建立時間。

    2023-09-16T02:49:04Z
    ModifyTime

    string

    浮水印提取作業的最後更新時間。

    2023-09-17T06:20:45Z
    Status

    string

    浮水印提取作業的狀態。取值：

    • Success：成功

    • Failed：失敗

    • Processing：處理中

    Failed
    ErrorMessage

    string

    報錯提示資訊。當浮水印提取作業處理失敗（即Status為Failed）時，才會返回本參數。

    query copyright info err
    WaterMarkText

    string

    提取出的浮水印文字。

    test mark

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "42E0554B-80F4-4921-****-ACFB22CAAAD0",
  "AiExtractResultList": [
    {
      "JobId": "3af004763bcf459698860f4ede20****",
      "CreateTime": "2023-09-16T02:49:04Z",
      "ModifyTime": "2023-09-17T06:20:45Z",
      "Status": "Failed",
      "ErrorMessage": "query copyright info err",
      "WaterMarkText": "test mark"
    }
  ]
}

    錯誤碼

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

    變更歷史

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