创建检索任务

调试

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

请求参数

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

系统规定参数。取值:AddSearchAudioTask。

AudioUrl String Http://xxx

音频地址

Description String 测试描述

描述

InstanceId String 1

实例ID

ClientToken String 1

幂等校验参数

ReturnAudioNumber Integer 1

返回音频数量

QueryTags String test

查询使用的tags

CallbackUrl String http://xxx

回调地址

ContentSource Integer 1

内容来源类型

AudioFile String http://xxx

文件中转URL (也可以是特征文件)

Sort Integer 1

优先级(0.低 1.中 2.高 3.紧急)

NeedFeatureFile Integer 0

是否需要特征文件 0.不需要 1.需要

ResourceType Integer 1

检索类型(1:音频搜索,2:音频特征搜索)

返回数据

名称 类型 示例值 描述
Data Struct

返回数据

TaskId String 1

任务ID

RequestId String 123

请求ID

示例

请求示例

http(s)://[Endpoint]/?Action=AddSearchAudioTask
&AudioUrl=Http://xxx
&Description=测试描述
&InstanceId=1
&<公共请求参数>

正常返回示例

JSON格式

{"RequestId":"123","Data":{"TaskId":"1"}}

错误码

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 The specified parameter %s is invalid. 参数无效
400 InvalidParameter.%s The specified parameter %s is invalid. 参数无效

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

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