调用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****"
}
错误码
访问错误中心查看更多错误码。