腾讯云-人脸识别(1948)-支持文档
[TOC]
用于创建一个空的人员库，如果人员库已存在返回错误。可根据需要创建自定义描述字段，用于辅助描述该人员库下的人员信息。1个APPID下最多创建2万个人员库（Group）、最多包含1000万张人脸（Face），单个人员库（Group）最多包含100万张人脸（Face）。
# 1. 准备一段人员信息
接口给出的示例值是：
{
"GroupName"："测试2号",
"GroupId":"3",
"Tag":"测试tag",
"GroupExDescriptions":["测试x","测试xx","测试xxx"]
}
# 2. 在易源测试页面进行调用
进入[易源测试界面](https://www.showapi.com/apiGateway/onlineTest?apiCode=1948&pointCode=7 "易源测试界面")，输入上述文本并进行调用，结果如图：
# 3. 调用代码
[点此进入接口详情界面](https://www.showapi.com/apiGateway/view/?apiCode=1948&pointCode=7 "点此进入接口详情界面")
示例代码如下图：
# 4. 错误码
如果返回结果中存在 Error 字段，则表示调用 API 接口失败。例如：
{
"Response": {
"Error": {
"Code": "AuthFailure.SignatureFailure",
"Message": "The provided credentials could not be validated. Please check your signature is correct."
},
"RequestId": "ed93f3cb-f35e-473f-b9f3-0d451b8b79c6"
}
}
Error 中的 Code 表示错误码，Message 表示该错误的具体信息。
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 [公共错误码](https://www.showapi.com/book/view/3624/41 "公共错误码")。
<table><thead><tr><th>错误码</th><th>描述</th></tr></thead><tbody><tr><td>FailedOperation.ConflictOperation</td><td>操作冲突，请勿同时操作相同的Person。</td></tr><tr><td>FailedOperation.DuplicatedGroupDescription</td><td>同一人员库中自定义描述字段不可重复。</td></tr><tr><td>FailedOperation.GroupInDeletedState</td><td>当前组正处于删除状态，请等待。</td></tr><tr><td>FailedOperation.GroupPersonMapExist</td><td>组中已包含对应的人员Id。</td></tr><tr><td>FailedOperation.GroupPersonMapNotExist</td><td>组中不包含对应的人员Id。</td></tr><tr><td>FailedOperation.ImageDecodeFailed</td><td>图片解码失败。</td></tr><tr><td>FailedOperation.ImageDownloadError</td><td>图片下载错误。</td></tr><tr><td>FailedOperation.ImageFacedetectFailed</td><td>人脸检测失败。</td></tr><tr><td>FailedOperation.ImageSizeExceed</td><td>base64编码后的图片数据大小不超过5M。</td></tr><tr><td>FailedOperation.RequestTimeout</td><td>后端服务超时。</td></tr><tr><td>FailedOperation.SearchFacesExceed</td><td>检索人脸个数超过限制。</td></tr><tr><td>FailedOperation.ServerError</td><td>算法服务异常，请重试。</td></tr><tr><td>InternalError</td><td>内部错误。</td></tr><tr><td>InvalidParameter.InvalidParameter</td><td>参数不合法。</td></tr><tr><td>InvalidParameterValue.AccountFaceNumExceed</td><td>账号脸数量超出限制。1个APPID下最多有1000W张人脸。</td></tr><tr><td>InvalidParameterValue.DeleteFaceNumExceed</td><td>删除人脸数量超出限制。每个人员至少需要包含一张人脸。</td></tr><tr><td>InvalidParameterValue.GroupExDescriptionsExceed</td><td>人员库自定义描述字段数组长度超过限制。最多可以创建5个。</td></tr><tr><td>InvalidParameterValue.GroupExDescriptionsNameIdentical</td><td>人员库自定义描述字段名称不可重复。</td></tr><tr><td>InvalidParameterValue.GroupExDescriptionsNameIllegal</td><td>人员库自定义描述字段名称包含非法字符。人员库自定义描述字段名称只支持中英文、-、_、数字。</td></tr><tr><td>InvalidParameterValue.GroupExDescriptionsNameTooLong</td><td>人员库自定义描述字段名称长度超出限制。</td></tr><tr><td>InvalidParameterValue.GroupFaceNumExceed</td><td>人员库人脸数量超出限制。单个人员库最多可以包含一百万张人脸。</td></tr><tr><td>InvalidParameterValue.GroupIdAlreadyExist</td><td>人员库ID已经存在。人员库ID不可重复。</td></tr><tr><td>InvalidParameterValue.GroupIdIllegal</td><td>人员库ID包含非法字符。人员库ID只支持英文、数字、-%@#&_。</td></tr><tr><td>InvalidParameterValue.GroupIdNotExist</td><td>人员库ID不存在。</td></tr><tr><td>InvalidParameterValue.GroupIdTooLong</td><td>人员库ID超出长度限制。</td></tr><tr><td>InvalidParameterValue.GroupIdsExceed</td><td>传入的人员库列表超过限制。</td></tr><tr><td>InvalidParameterValue.GroupNameAlreadyExist</td><td>人员库名称已经存在。人员库名称不可重复。</td></tr><tr><td>InvalidParameterValue.GroupNameIllegal</td><td>人员库名称包含非法字符。人员库名称只支持中英文、-、_、数字。</td></tr><tr><td>InvalidParameterValue.GroupNameTooLong</td><td>人员库名称超出长度限制。</td></tr><tr><td>InvalidParameterValue.GroupNumExceed</td><td>人员库数量超出限制。人员库最多可以创建2万个，如需增加，请联系我们。</td></tr><tr><td>InvalidParameterValue.GroupNumPerPersonExceed</td><td>人员库数量超出限制。单个人员最多可被添加至100个人员库。</td></tr><tr><td>InvalidParameterValue.GroupTagIllegal</td><td>人员库备注包含非法字符。人员库备注只支持中英文、-、_、数字。</td></tr><tr><td>InvalidParameterValue.GroupTagTooLong</td><td>人员库备注超出长度限制。</td></tr><tr><td>InvalidParameterValue.ImageEmpty</td><td>图片为空。</td></tr><tr><td>InvalidParameterValue.LimitExceed</td><td>返回数量超出限制。</td></tr><tr><td>InvalidParameterValue.NoFaceInGroups</td><td>指定分组中没有人脸。</td></tr><tr><td>InvalidParameterValue.NoFaceInPhoto</td><td>图片中没有人脸。</td></tr><tr><td>InvalidParameterValue.OffsetExceed</td><td>起始序号过大。请检查需要请求的数组长度。</td></tr><tr><td>InvalidParameterValue.PersonExDescriptionInfosExceed</td><td>人员自定义描述字段数组长度超过限制。最多5个。</td></tr><tr><td>InvalidParameterValue.PersonExDescriptionsNameIdentical</td><td>人员自定义描述字段名称不可重复。</td></tr><tr><td>InvalidParameterValue.PersonExDescriptionsNameIllegal</td><td>人员自定义描述字段名称包含非法字符。人员自定义描述字段名称只支持中英文、-、_、数字。</td></tr><tr><td>InvalidParameterValue.PersonExDescriptionsNameTooLong</td><td>人员自定义描述字段名称长度超出限制。</td></tr><tr><td>InvalidParameterValue.PersonExistInGroup</td><td>组中已包含对应的人员Id。</td></tr><tr><td>InvalidParameterValue.PersonFaceNumExceed</td><td>人员人脸数量超出限制。单个人员最多可以包含五张人脸。</td></tr><tr><td>InvalidParameterValue.PersonGenderIllegal</td><td>人员性别设置出错。0代表未填写，1代表男性，2代表女性。</td></tr><tr><td>InvalidParameterValue.PersonIdAlreadyExist</td><td>人员ID已经存在。人员ID不可重复。</td></tr><tr><td>InvalidParameterValue.PersonIdIllegal</td><td>人员ID包含非法字符。人员ID只支持英文、数字、-%@#&_。</td></tr><tr><td>InvalidParameterValue.PersonIdNotExist</td><td>人员ID不存在。</td></tr><tr><td>InvalidParameterValue.PersonIdTooLong</td><td>人员ID超出长度限制。</td></tr><tr><td>InvalidParameterValue.PersonNameIllegal</td><td>人员名称包含非法字符。人员名称只支持中英文、-、_、数字。</td></tr><tr><td>InvalidParameterValue.PersonNameTooLong</td><td>人员名称超出长度限制。</td></tr><tr><td>InvalidParameterValue.SearchPersonsExceed</td><td>搜索的人员数目超过限制。</td></tr><tr><td>InvalidParameterValue.UploadFaceNumExceed</td><td>一次最多上传四张人脸。</td></tr><tr><td>InvalidParameterValue.UrlIllegal</td><td>URL格式不合法。</td></tr><tr><td>LimitExceeded.ErrorFaceNumExceed</td><td>人脸个数超过限制。</td></tr><tr><td>MissingParameter.ErrorParameterEmpty</td><td>必选参数为空。</td></tr><tr><td>ResourceUnavailable.Delivering</td><td>资源正在发货中。</td></tr><tr><td>ResourceUnavailable.Freeze</td><td>帐号已被冻结。</td></tr><tr><td>ResourceUnavailable.InArrears</td><td>帐号已欠费。</td></tr><tr><td>ResourceUnavailable.NotExist</td><td>计费状态未知，请确认是否已在控制台开通服务。</td></tr><tr><td>ResourceUnavailable.Recover</td><td>资源已被回收。</td></tr><tr><td>ResourceUnavailable.StopUsing</td><td>帐号已停服。</td></tr><tr><td>ResourceUnavailable.UnknownStatus</td><td>计费状态未知。</td></tr><tr><td>ResourcesSoldOut.ChargeStatusException</td><td>计费状态异常。</td></tr><tr><td>UnsupportedOperation.UnknowMethod</td><td>未知方法名。</td></tr></tbody></table>