调用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详情

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

错误码

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