SubmitFpShotJob
查询DNA底库中是否存在相同或者相近的DNA结果
服务地址:
华东1(杭州)
输入参数
只看必填
Input作业输入文件地址
PipelineId管道ID
FpShotConfig视频DNA配置
UserData用户自定义数据
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 本接口可以提交视频、音频、图片和文本 DNA 作业。
  • 本接口为异步接口。不保证接口返回时结果已经生成,结果完成后将发送异步消息。
  • DNA 相关接口功能,目前开通的地域为华北 2(北京)、华东 2(上海)、华东 1(杭州)、亚太东南 1(新加坡)、沙特(利雅得)由合作伙伴运营,其他地域暂不支持。其中,文本 DNA 相关功能,目前仅支持华东 2(上海)地域使用。
  • 输入文件格式限制如下:
    • 图片格式:jpeg、png、bmp。
    • 视频格式:mp4、avi、mkv、mpg、ts、mov、flv、mxf。
    • 视频编码:MPEG2、MPEG4、H264、HEVC、WMV。
  • 文本 DNA 使用场景:底库仅支持入库 TextType=Text 的长文本字符串,搜索指定 TextType=ASR 的输入是 ASR 识别结果,包含 start、end、text 的 JSON 字符串数组。

QPS 限制

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

请求参数

字段名称字段详情
Inputstring

作业输入文件地址,支持 OSS 地址、HTTP 地址、视频点播(VoD)媒资等形式。展开详情

示例值:{"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"}
PipelineIdstring

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

示例值:88c6ca184c0e47098a5b665e2a12****
FpShotConfigstring

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

示例值:{ "PrimaryKey": "12345****", "SaveType": "save", "FpDBId": "417f2ada5999daf****" }参考取值来源:
    QueryFpShotJobList
UserDatastring

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

示例值:testid-****

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:25818875-5F78-4A13-BEF6-D7393642CA58
JobIdstring

视频 DNA 作业 ID。建议您保存此 ID 便于后续调用其他相关接口时使用。

示例值:2a0697e35a7342859f733a9190c4****

返回说明

异步通知消息参数

名称类型描述
TypeString消息类型。
FpShotJobNotifyAliyunFpShotJobNotify视频 DNA 作业,参见数据类型 AliyunFpShotJobNotify
UserDataString用户自定义数据。
变更历史
暂无变更历史