本文档介绍添加人脸数据AddFace的语法及示例。
功能描述
添加人脸数据可以为指定数据库添加人脸数据,总共可支持100万张人脸照片的入库,每个人脸样本最多可以添加5张人脸照片。如有更多需求请提工单申请。
前提条件
输入限制
- 图片格式:JPG、JPEG、PNG。
- 图片大小:不超过5M。
- 图片像素:大于5×5像素,小于4096×4096像素。人脸尺寸建议大于64×64像素。
- URL地址中不能包含中文字符。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | AddFace |
要执行的操作。取值:AddFace。 |
DbName | String | 是 | default |
数据库名称。支持小写字母、数字、下划线的组合,长度1~64。 |
EntityId | String | 是 | U1 |
实体ID,用来标识用户的唯一性,如用户ID、员工ID等。每个实体可包含多张人脸图片。支持大小写字母、数字、下划线、减号的组合,长度为2~64。 |
ImageUrl | String | 是 | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/1.png |
人脸图片地址,人脸必须是正面无遮挡单人人脸。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
ExtraData | String | 否 | 王小二 |
自定义信息。支持字母、数字、标点符号和汉字。不超过512个字符。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct |
返回的结果数据内容。 |
|
FaceId | String | 5 |
输出人脸ID。 |
RequestId | String | 2B93C43A-F824-40C8-AF79-844342B0F43A |
请求ID。 |
示例
请求示例
http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=AddFace
&DbName=default
&EntityId=U1
&FaceId=001
&ImageUrl=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/1.png
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>2B93C43A-F824-40C8-AF79-844342B0F43A</RequestId>
<FaceId>5</FaceId>
JSON
格式
{
"RequestId": "2B93C43A-F824-40C8-AF79-844342B0F43A",
"FaceId":"5"
}
错误码
关于添加人脸数据的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
在文档使用中是否遇到以下问题
更多建议
匿名提交