人体搜索-阿里云帮助中心

功能描述

使用人体搜索功能，可用于对一组输入的人体轨迹在人体库中识别出最相似的TopN人体，按照相似度从大到小排列。

前提条件

请确保您已开通人脸人体服务，若未开通服务请立即开通。

输入限制

图片格式：JPG、JPEG、PNG。
图片大小：小于512KB。
图片像素：大于32×32像素，小于2048×2048像素。输入图片建议分辨率为256×128像素。
每个图片中只包含一个人体。
URL地址中不能包含中文字符。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	SearchBodyTrace	系统规定参数。取值：SearchBodyTrace。
DbId	Long	是	123	数据库ID。
Images	Array	否		1个人体轨迹的图片信息列表，至少1个，最多5个。
ImageURL	String	否	https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/1.png	图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见生成URL。
ImageData	String	否	iVBORw0KGgoAAAANSUhEUgAAASUAA****	图像的Base64编码字符串。
Limit	Long	否	10	结果人体轨迹的数量上限，默认10，取值范围`[1,100]`。说明例如，该参数设置为10，根据返回参数中Score的分值进行倒序排序，则取前10个结果集。
MinScore	Float	否	0.1	匹配度最低阈值，只返回大于等于该阈值的数据，取值范围`[-1.0, 1.0]`，默认为空（不进行过滤）。

返回数据


名称	类型	示例值	描述
RequestId	String	96464567-2051-4048-A2A0-52C29E513A7E	请求ID。
Data	Object		返回的结果数据内容。
MatchList	Array of Trace		匹配的人体轨迹列表。
DbId	Long	123	数据库ID。
PersonId	Long	18283	人员ID。
TraceId	Long	10769560	1个人体轨迹的ID，同一个数据库下ID唯一不重复。
Score	Float	0.5	匹配度分值，越大越相似，取值范围`[-1.0,1.0]`。具体的阈值定义请根据自己的业务场景进行判断。
ExtraData	String	这是唐嫣	用户自定义信息。说明为在添加人体轨迹AddBodyTrace接口中添加的关联信息。

示例

请求示例

http(s)://[Endpoint]/?Images=[{"ImageURL":"https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/1.png"}]
&DbId=123
&Limit=10
&MinScore=0.1
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>96464567-2051-4048-A2A0-52C29E513A7E</RequestId>
<Data>
    <MatchList>
        <Score>0.5</Score>
        <PersonId>18283</PersonId>
        <DbId>123</DbId>
        <TraceId>10769560</TraceId>
        <ExtraData>这是唐嫣</ExtraData>
    </MatchList>
</Data>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "96464567-2051-4048-A2A0-52C29E513A7E",
  "Data" : {
    "MatchList" : [ {
      "Score" : "0.5",
      "PersonId" : "18283",
      "DbId" : "123",
      "TraceId" : "10769560",
      "ExtraData" : "这是唐嫣"
    } ]
  }
}

错误码

关于人体搜索的错误码，详情请参见常见错误码。

SDK参考

阿里云视觉AI能力支持使用SDK调用，具体可参见SDK总览下载安装。

安全声明

请确保上传的图片或文件来源符合相应的法律法规。
通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。