调用该接口创建一体化以图搜图任务。

一体化以图搜图，指在搜图时，同时检索人脸和人体特征。

说明 该功能需要在V系列边缘一体机上部署人脸和人体检测算法。

调试

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

请求参数

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

系统规定参数。取值：CreatePictureSearchJob。
AppInstanceId String 是 3e429560124b44b685095df81a27****

以图搜图应用实例ID。可调用QueryPictureSearchApps查询。

EndTime Long 是 1614327915000

检索范围结束时间，格式为13位时间戳，单位为毫秒。
SearchPicUrl String 是 http://xxx.xxx/1.jpg

待检索图片的地址。
StartTime Long 是 1614227915000

检索范围起始时间，格式为13位时间戳，单位为毫秒。
Threshold Float 是 0.5

人脸检索阈值。取值范围为0~1。

为保证检索结果的准确性，推荐设置该参数在0.3~0.6之间。
BodyThreshold Float 否 0.9

人体检索阈值。取值范围为0~1。

为保证检索结果的准确性，推荐设置该参数大于等于0.8。若不设置，则取值为Threshold参数的值。
PictureSearchType Integer 否 1

检索类型：

  • 1：人脸
  • 0：人体

默认为1。

调用API时，除了本文介绍的该API的特有请求参数，还需传入公共请求参数。公共请求参数说明，请参见公共参数文档。

返回数据

名称 类型 示例值 描述
Code String 200

调用失败时，返回的错误码。更多信息，请参见错误码。

Data String 71632df011294a85910c566e7181****

以图搜图任务ID。
ErrorMessage String The request has failed due to a temporary failure of the server.

调用失败时，返回的出错信息。
RequestId String FAEBE068-07DE-4B88-AC2A-51FC2B556211

阿里云为该请求生成的唯一标识符。
Success Boolean true

是否调用成功：

  • true：调用成功。
  • false：调用失败。

示例

请求示例

http(s)://linkvisual.cn-shanghai.aliyuncs.com/?Action=CreatePictureSearchJob
&AppInstanceId=3e429560124b44b685095df81a27****
&EndTime=1614327915000
&SearchPicUrl=http://xxx.xxx/1.jpg
&StartTime=1614227915000
&Threshold=0.5
&<公共请求参数>

正常返回示例

XML格式 

<CreatePictureSearchJobResponse>
  <RequestId>DB14A78C-6F64-40D0-8C03-46E8D57A8FC8</RequestId>
  <Data>71632df011294a85910c566e7181****</Data>
  <Code>200</Code>
  <Success>true</Success>
</CreatePictureSearchJobResponse>

JSON格式 

{
  "RequestId": "DB14A78C-6F64-40D0-8C03-46E8D57A8FC8",
  "Data": "71632df011294a85910c566e7181****",
  "Code": "200",
  "Success": true
}

错误码

HttpCode 错误码 错误信息 描述
400 Forbidden.RiskControl Your account is at risk. Contact customer support for more details. 无权限

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