使用QueryFpShotJobList API查詢DNA作業結果-ApsaraVideo for Media Processing-阿里雲

查詢DNA作業結果，本介面支援查詢所有類型的DNA作業結果。

介面說明

提交 DNA 作業後，DNA 服務會進行 DNA 對比，通過本介面可以查詢作業結果。
查詢文本 DNA 作業目前僅支援華東 2（上海）地區使用。
本介面只支援查詢六個月以內的 DNA 任務資訊。

QPS 限制

本介面的單使用者 QPS 限制為 100 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。更多資訊，請參見 QPS 限制。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

mts:QueryFpShotJobList

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
JobIds	string	否	需要查詢的 DNA 作業 ID 列表，可以通過 MPS 控制台 > 任務管理 > 視頻 DNA擷取。一次最多查詢 10 個，用半形逗號（,）分隔。	88c6ca184c0e47098a5b665e2a12****
NextPageToken	string	否	下一頁標識。第一次請求無需傳入，服務會返回，第二次請求傳入即可。	16f01ad6175e4230ac42bb5182cd****
MaximumPageSize	integer	否	每頁最大返回數。預設：10 取值：1~100	10
State	string	否	需要查詢的作業狀態。取值： All：全部。 Queuing：排隊中。 Analysing：分析中。 Fail：失敗。 Success：成功。	All
StartOfJobCreatedTimeRange	string	否	最早任務建立時間。日期格式按照 ISO8601 標準表示，並需要使用 UTC 時間。格式為：YYYY-MM-DDThh:mm:ssZ 。	2021-12-22T03:48:05Z
EndOfJobCreatedTimeRange	string	否	最晚任務建立時間。日期格式按照 ISO8601 標準表示，並需要使用 UTC 時間。格式為：YYYY-MM-DDThh:mm:ssZ 。	2022-02-14T02:16:07Z
PipelineId	string	否	管道 ID。可以通過ApsaraVideo for Media Processing控制台 > 全域設定 > 管道及回調擷取。	b11c171cced04565b1f38f1ecc39****

返回參數

名稱	類型	描述	樣本值
	object	返回參數。
RequestId	string	請求 ID。	25818875-5F78-4A13-BEF6-D7393642CA58
NextPageToken	string	下一頁標識。需記錄下來，在下一次請求時傳入即可。	b11c171cced04565b1f38f1ecc39****
FpShotJobList	object
FpShotJob	array<object>	DNA 作業資訊。
	array<object>	DNA 作業資訊詳情。
FpShotResult	object	DNA 作業查詢結果。
AudioFpShots	object
FpShot	array<object>	音頻 DNA 查詢結果。
	array<object>	音頻 DNA 查詢結果詳細資料。
PrimaryKey	string	唯一主鍵。	498ac941373341599c4777c8d884****
FpShotSlices	object
FpShotSlice	array<object>	相似音頻。
	array<object>	相似音頻詳細資料。
Duplication	object	DNA 庫中音訊開始時間和時間長度。
Start	string	開始時間。	0
Duration	string	時間長度。	3
Similarity	string	音頻片段相似性。	0
Input	object	輸入音訊開始時間和時間長度。
Start	string	開始時間。	0
Duration	string	時間長度。	5
Similarity	string	音頻整體相似性。	0
FpShots	object
FpShot	array<object>	視頻 DNA 查詢結果。
	array<object>	視頻 DNA 查詢結果詳細資料。
PrimaryKey	string	視頻唯一主鍵。	498ac941373341599c4777c8d884****
FpShotSlices	object
FpShotSlice	array<object>	相似視頻。
	array<object>	相似視頻詳情。
Duplication	object	DNA 庫中視頻的開始時間和時間長度。
Start	string	開始時間。	1260
Duration	string	時間長度。	48
Similarity	string	視頻片段相似性。	0
Input	object	輸入視頻的開始時間和時間長度。
Start	string	開始時間。	46
Duration	string	時間長度。	48
Similarity	string	視頻整體相似性。說明整體相似性是片段相似性的平均值。如果 DNA 庫中存在多個相似段，會返回多個命中結果。	0.8914769887924194
TextFpShots	object
TextFpShot	array<object>	文本 DNA 查詢結果。
	array<object>	文本 DNA 查詢結果詳細資料。
PrimaryKey	string	文本唯一主鍵。	3e34ac649945b53a1b0f863ce030****
Similarity	string	文本相似性。	1.0
TextFpShotSlices	object
TextFpShotSlice	array<object>	重複文本。
	array<object>	重複文本詳細資料。
Similarity	string	匹配片段的信賴度。	1.0
InputText	string	查詢匹配的文本片段。	今天下雪了
DuplicationText	string	底庫匹配的文本片段。	今天下雪了
InputFragment	object	查詢匹配片段起始時間和時間長度。
Start	string	起始時間。	0
Duration	string	時間長度。	3
CreationTime	string	建立時間。	2017-01-10T12:00:00Z
FinishTime	string	完成時間。	0
State	string	作業狀態，可取值： Queuing：排隊中。 Analysing：分析中。 Success：成功。 Fail：失敗。	Success
Message	string	分析失敗時錯誤資訊。如果執行成功則不返回此參數。	The parameter \"Id\" is invalid.A uuid must:1)be comprised of chracters[a-f],numbers[0-9];2)be 32 characters long
FpShotConfig	object	配置。
PrimaryKey	string	唯一的視頻主鍵，唯一性由使用者保證。	3ca84a39a9024f19853b21be9cf9****
SaveType	string	儲存類型，取值： nosave：不入庫。 save：去重入庫。 forcesave：強制入庫。	save
FpDBId	string	DNA 庫 ID。	2288c6ca184c0e47098a5b665e2a12****
FileId	string	檔案 ID。	ebb51ee30f0b49aba959823fa991****
UserData	string	使用者自訂資料。	testid-001
Duration	integer	輸入檔案時間長度，單位秒。	5
Code	string	分析失敗時錯誤碼。	InvalidParameter.UUIDFormatInvalid
InputFile	object	作業輸入。
Object	string	作業輸入所在的 OSS Object。	test.mp4
Location	string	作業輸入所在的 OSS Location。	oss-cn-beiing
Bucket	string	作業輸入所在的 OSS Bucket。	oss-test
PipelineId	string	管道 ID。	88c6ca184c0e47098a5b665e2a12****
Id	string	作業 ID。	88c6ca184c0e47098a5b665e2a12****
Input	string	作業輸入。	{"Bucket":"oss-test","Location":"oss-cn-beiing","Object":"test.mp4"}
NonExistIds	object
String	array	不存在的作業 ID 列表。
	string	不存在的作業 ID 列表，無資料時該參數不返回。	ae687c02fe944327ba9631e50da23128****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "NextPageToken": "b11c171cced04565b1f38f1ecc39****",
  "FpShotJobList": {
    "FpShotJob": [
      {
        "FpShotResult": {
          "AudioFpShots": {
            "FpShot": [
              {
                "PrimaryKey": "498ac941373341599c4777c8d884****",
                "FpShotSlices": {
                  "FpShotSlice": [
                    {
                      "Duplication": {
                        "Start": "0",
                        "Duration": "3"
                      },
                      "Similarity": "0",
                      "Input": {
                        "Start": "0",
                        "Duration": "5"
                      }
                    }
                  ]
                },
                "Similarity": "0"
              }
            ]
          },
          "FpShots": {
            "FpShot": [
              {
                "PrimaryKey": "498ac941373341599c4777c8d884****",
                "FpShotSlices": {
                  "FpShotSlice": [
                    {
                      "Duplication": {
                        "Start": "1260",
                        "Duration": "48"
                      },
                      "Similarity": "0",
                      "Input": {
                        "Start": "46",
                        "Duration": "48"
                      }
                    }
                  ]
                },
                "Similarity": "0.8914769887924194"
              }
            ]
          },
          "TextFpShots": {
            "TextFpShot": [
              {
                "PrimaryKey": "3e34ac649945b53a1b0f863ce030****",
                "Similarity": "1.0",
                "TextFpShotSlices": {
                  "TextFpShotSlice": [
                    {
                      "Similarity": "1.0",
                      "InputText": "今天下雪了",
                      "DuplicationText": "今天下雪了",
                      "InputFragment": {
                        "Start": "0",
                        "Duration": "3"
                      }
                    }
                  ]
                }
              }
            ]
          }
        },
        "CreationTime": "2017-01-10T12:00:00Z",
        "FinishTime": "0",
        "State": "Success",
        "Message": "The parameter \\\"Id\\\" is invalid.A uuid must:1)be comprised of chracters[a-f],numbers[0-9];2)be 32 characters long",
        "FpShotConfig": {
          "PrimaryKey": "3ca84a39a9024f19853b21be9cf9****",
          "SaveType": "save",
          "FpDBId": "2288c6ca184c0e47098a5b665e2a12****"
        },
        "FileId": "ebb51ee30f0b49aba959823fa991****",
        "UserData": "testid-001",
        "Duration": 5,
        "Code": "InvalidParameter.UUIDFormatInvalid",
        "InputFile": {
          "Object": "test.mp4",
          "Location": "oss-cn-beiing",
          "Bucket": "oss-test"
        },
        "PipelineId": "88c6ca184c0e47098a5b665e2a12****",
        "Id": "88c6ca184c0e47098a5b665e2a12****",
        "Input": "{\"Bucket\":\"oss-test\",\"Location\":\"oss-cn-beiing\",\"Object\":\"test.mp4\"}"
      }
    ]
  },
  "NonExistIds": {
    "String": [
      "ae687c02fe944327ba9631e50da23128****"
    ]
  }
}

錯誤碼

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

變更歷史

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