调用该接口创建一体化以图搜图任务，即同时检索人脸和人体特征的任务。

使用限制

  • 单个阿里云账号调用该接口的每秒请求数（QPS）最大限制为100。
    说明 RAM用户共享阿里云账号配额。
  • 请提前在V系列边缘一体机上部署人脸和人体检测算法。
  • 请提前为待检索图片，配置URL地址。
    说明 当前仅支持JPG格式的图片，且图片URL中不能包含中文。

调试

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

请求参数

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

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

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

StartTime Long 是 1614227915000

检索起始时间，格式为13位时间戳，单位为毫秒。
EndTime Long 是 1614327915000

检索结束时间，格式为13位时间戳，单位为毫秒。
SearchPicUrl String 是 https://example.com/test.jpg

待检索图片的地址，支持JPG格式的图片，且图片URL不能包含中文。
Threshold Float 是 0.5

人脸检索阈值，取值范围为0.0~1.0。

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

人体检索阈值，取值范围为0.0~1.0。

说明
  • 为保证检索结果的准确性，推荐您将该参数值设置为大于等于0.8。
  • 若此处不设置，则人体检索阈值，默认为与Threshold参数值相同。
PictureSearchType Integer 否 1

检索类型：

  • 1（默认）：人脸
  • 0：人体

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

返回数据

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

接口返回码：

  • 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****
&StartTime=1614227915000
&EndTime=1614327915000
&SearchPicUrl=https://example.com/test.jpg
&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
}