创建视频检索任务

调试

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

请求参数

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

系统规定参数。取值：AddSearchVideoTask。
InstanceId String 是 testInstance000

处理任务的实例id
StorageType Integer 是 2

入库类型（1. 直接入库 2. 覆盖入库 3. 不入库）
VideoId String 是 testVideoId

视频id
VideoTags String 是 testVideoTag

视频标签
VideoUrl String 是 https://mediaai-test-huadong2.oss-cn-shanghai.aliyuncs.com/perf/1_480p_25M.mp4

视频url
ClientToken String 否 clientToken

幂等参数，用于接口幂等判断
ReturnVideoNumber Integer 否 10

检索结果返回的最大相似视频数量
QueryTags String 否 testVideoTag|testVideoTag1

查询条件，与视频标签对应，多个查询条件使用逗号（ , ）分割
CallbackUrl String 否 http://testcallback.aliyun.com

任务结束时的回调url，仅支持http请求
ReplaceStorageThreshold Float 否 0.75

覆盖入库阈值，StorageType为2（覆盖入库）时生效，当检索结果中所有视频的置信度都小于该值时，进行数据入库

返回数据

名称 类型 示例值 描述
Data Struct

返回结果
TaskId String 200001

任务id
RequestId String 1ABBE852-6313-49F9-BF8A-6FDF9A4C0617

请求id

示例

请求示例

http(s)://[Endpoint]/?Action=AddSearchVideoTask
&InstanceId=testInstance000
&StorageType=2
&VideoId=testVideoId
&VideoTags=testVideoTag
&VideoUrl=https://mediaai-test-huadong2.oss-cn-shanghai.aliyuncs.com/perf/1_480p_25M.mp4
&<公共请求参数>

正常返回示例

XML 格式 

<RequestId>1ABBE852-6313-49F9-BF8A-6FDF9A4C0617</RequestId>
<Data>
    <TaskId>200001</TaskId>
</Data>

JSON 格式 

{
    "RequestId": "1ABBE852-6313-49F9-BF8A-6FDF9A4C0617",
    "Data": {
        "TaskId": 200001
    }
}

错误码

HttpCode 错误码 错误信息 描述
400 Duplicate.TagKey The Tag.N.Key contains duplicate keys. 标签key重复
403 ForBidden You are not authorized to perform the operation. 无权限，请求被拒绝
400 InvalidInstanceStatus The status of the instance %s is invalid. 实例状态无效，不能用于处理任务
400 InvalidParameterList You must specify the parameter %s. 缺少参数
400 InvalidTagCount The maximum number of tags is exceeded. 标签个数过多
400 InvalidTagKey.Malformed The specified Tag.N.Value is not valid. 无效的标签key
400 InvalidTagValue.Malformed The specified Tag.N.Value is not valid. 无效的标签值
401 ServiceNotOpened The service is not activated. 服务未开通
401 Unauthorized You are not authorized to perform the operation. 没有访问权限
400 InvalidParameter.%s The specified parameter %s is invalid. 参数无效

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

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