调用SubmitFpShotJob提交DNA作业，查询DNA库中是否存在相同或相近的结果。

使用说明

  • 本接口可以提交视频DNA作业和文本DNA作业。
  • 本接口为异步接口。不保证接口返回时结果已经生成，结果完成后将发送异步消息。
  • 提交文本DNA作业目前仅支持华东2（上海）地域使用。输入文件格式限制如下：
    • 图片格式：jpeg、png、bmp。
    • 视频格式：mp4、avi、mkv、mpg、ts、mov、flv、mxf。
    • 视频编码：MPEG2、MPEG4、H264、HEVC、WMV。

QPS限制

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 SubmitFpShotJob

操作接口名，系统规定参数，取值：SubmitFpShotJob。

Input String 是 {“Bucket”:”example-bucket-****”,“Location”:”oss-cn-shanghai”,“Object”:”example-****.flv”}

作业输入文件OSS地址，JSON对象，可以通过OSS或MPS控制台获取。更多信息请参见InputFile详情。

说明 OSS的地域需要与当前MPS所在地域保持一致。
PipelineId String 否 88c6ca184c0e47098a5b665e2a12****

管道ID，用于绑定消息通知。可通过媒体处理控制台>全局设置>管道获取。

FpShotConfig String 是 {“PrimaryKey”:”12345****”, “SaveType”: “save”}

视频DNA配置，JSON对象。更多信息请参见FpShotConfig详情。

UserData String 否 testid-****

用户自定义数据，最大长度128个字节，不能以特殊字符开头。

返回数据

名称 类型 示例值 描述
RequestId String 25818875-5F78-4A13-BEF6-D7393642CA58

请求ID。
JobId String 2a0697e35a7342859f733a9190c4****

视频DNA作业ID。建议您保存此ID便于后续调用其他相关接口时使用。
异步通知消息参数

名称

类型

描述

Type

String

消息类型。

FpShotJobNotify

AliyunFpShotJobNotify

视频DNA作业，参见数据类型AliyunFpShotJobNotify。

UserData

String

用户自定义数据。

示例

请求示例

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=SubmitFpShotJob
&Input={“Bucket”:”example-bucket-****”,“Location”:”oss-cn-shanghai”,“Object”:”example-****.flv”}
&PipelineId=88c6ca184c0e47098a5b665e2a12****
&FpShotConfig={“PrimaryKey”:”12345****”, “SaveType”: “save”}
&UserData=testid-****
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<SubmitFpShotJobResponse>
    <RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
    <JobId>2a0697e35a7342859f733a9190c4****</JobId>
</SubmitFpShotJobResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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