文档

QueryFpShotJobList - 查询DNA作业结果

更新时间:

查询DNA作业结果,本接口支持查询所有类型的DNA作业结果。

接口说明

  • 提交 DNA 作业后,DNA 服务会进行 DNA 对比,通过本接口可以查询作业结果。
  • 查询文本 DNA 作业目前仅支持华东 2(上海)地域使用。

QPS 限制

本接口的单用户 QPS 限制为 100 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见 QPS 限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
JobIdsstring

需要查询的 DNA 作业 ID 列表,可以通过** MPS 控制台** > 任务管理 > 视频 DNA获取。一次最多查询 10 个,用半角逗号(,)分隔。

88c6ca184c0e47098a5b665e2a12****
NextPageTokenstring

下一页标识。第一次请求无需传入,服务会返回,第二次请求传入即可。

16f01ad6175e4230ac42bb5182cd****
MaximumPageSizelong

每页最大返回数。

  • 默认:10
  • 取值:1~100
10
Statestring

需要查询的作业状态。取值:

  • All:全部。
  • Queuing:排队中。
  • Analysing:分析中。
  • Fail:失败。
  • Success:成功。
All
StartOfJobCreatedTimeRangestring

最早任务创建时间。

  • 日期格式按照 ISO8601 标准表示,并需要使用 UTC 时间。
  • 格式为:YYYY-MM-DDThh:mm:ssZ 。
2021-12-22T03:48:05Z
EndOfJobCreatedTimeRangestring

最晚任务创建时间。

  • 日期格式按照 ISO8601 标准表示,并需要使用 UTC 时间。
  • 格式为:YYYY-MM-DDThh:mm:ssZ 。
2022-02-14T02:16:07Z
PipelineIdstring

管道 ID。可以通过媒体处理控制台 > 全局设置 > 管道获取。

b11c171cced04565b1f38f1ecc39****

返回参数

名称类型描述示例值
object

返回参数。

RequestIdstring

请求 ID。

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

下一页标识。需记录下来,在下一次请求时传入即可。

b11c171cced04565b1f38f1ecc39****
FpShotJobListobject []

DNA 作业信息。

FpShotResultobject

DNA 作业查询结果。

AudioFpShotsobject []

音频 DNA 查询结果。

PrimaryKeystring

唯一主键。

498ac941373341599c4777c8d884****
FpShotSlicesobject []

相似音频。

Duplicationobject

DNA 库中音频的开始时间和时长。

Startstring

开始时间。

0
Durationstring

时长。

3
Similaritystring

音频片段相似度。

0
Inputobject

输入音频的开始时间和时长。

Startstring

开始时间。

0
Durationstring

时长。

5
Similaritystring

音频整体相似度。

0
FpShotsobject []

视频 DNA 查询结果。

PrimaryKeystring

视频唯一主键。

498ac941373341599c4777c8d884****
FpShotSlicesobject []

相似视频。

Duplicationobject

DNA 库中视频的开始时间和时长。

Startstring

开始时间。

1260
Durationstring

时长。

48
Similaritystring

视频片段相似度。

0
Inputobject

输入视频的开始时间和时长。

Startstring

开始时间。

46
Durationstring

时长。

48
Similaritystring

视频整体相似度。

说明 整体相似度是片段相似度的平均值。如果 DNA 库中存在多个相似段,会返回多个命中结果。
0.8914769887924194
TextFpShotsobject []

文本 DNA 查询结果。

PrimaryKeystring

文本唯一主键。

3e34ac649945b53a1b0f863ce030****
Similaritystring

文本相似度。

1.0
TextFpShotSlicesobject []

重复文本。

Similaritystring

匹配片段的置信度。

1.0
InputTextstring

查询匹配的文本片段。

今天下雪了
DuplicationTextstring

底库匹配的文本片段。

今天下雪了
InputFragmentobject

查询匹配片段起始时间和时长。

Startstring

起始时间。

0
Durationstring

时长。

3
CreationTimestring

创建时间。

2017-01-10T12:00:00Z
FinishTimestring

完成时间。

0
Statestring

作业状态,可取值:

  • Queuing:排队中。

  • Analysing:分析中。

  • Success:成功。

  • Fail:失败。

Success
Messagestring

分析失败时错误信息。如果执行成功则不返回此参数。

The parameter \"Id\" is invalid.A uuid must:1)be comprised of chracters[a-f],numbers[0-9];2)be 32 characters long
FpShotConfigobject

配置。

PrimaryKeystring

唯一的视频主键,唯一性由用户保证。

3ca84a39a9024f19853b21be9cf9****
SaveTypestring

存储类型,取值:

  • nosave:不入库。

  • save:去重入库。

  • forcesave:强制入库。

save
FpDBIdstring

DNA 库 ID。

2288c6ca184c0e47098a5b665e2a12****
FileIdstring

文件 ID。

ebb51ee30f0b49aba959823fa991****
UserDatastring

用户自定义数据。

testid-001
Durationinteger

输入文件时长,单位秒。

5
Codestring

分析失败时错误码。

InvalidParameter.UUIDFormatInvalid
InputFileobject

作业输入。

Objectstring

作业输入所在的 OSS Object。

test.mp4
Locationstring

作业输入所在的 OSS Location。

oss-cn-beiing
Bucketstring

作业输入所在的 OSS Bucket。

oss-test
PipelineIdstring

管道 ID。

88c6ca184c0e47098a5b665e2a12****
Idstring

作业 ID。

88c6ca184c0e47098a5b665e2a12****
Inputstring

作业输入。

{"Bucket":"oss-test","Location":"oss-cn-beiing","Object":"test.mp4"}
NonExistIdsarray

不存在的作业 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****"
    ]
  }
}

错误码

访问错误中心查看更多错误码。

  • 本页导读 (1)
文档反馈