创建人脸库
功能介绍
创建用于存储人脸特征的人脸库。您最多可以创建10个人脸库，每个人脸库最大容量为10万个人脸特征。如有更大规格的需求请联系客服。
前提条件：
application/json请求的body中，请使用标准Json格式。
URI
- URI格式
POST /v1/{project_id}/face-sets - 参数说明
参数名
参数类型
是否必选
说明
project_id
String
是
项目ID，获取方法请参见获取项目ID/账号名/AK/SK。
请求消息
参数名 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|
face_set_name |
String |
是 |
人脸库的名称。 建议人脸库的名称不要以下划线“_”开头，否则云监控服务会无法采集人脸数量。 |
face_set_capacity |
Integer |
否 |
人脸库最大的容量，填写1万整数倍的数字，例如：30000。 默认为100000，最大值为100000，可通过创建新的人脸库进行扩容，每个用户可免费使用10个人脸库，每个人脸库容量为10万个人脸特征。如需扩容单个人脸库规模，请联系华为云客服确认扩容规模与价格。 |
external_fields |
Json |
否 |
用户自定义数据，自定义字段不能以系统保留字段vector、bounding_box、external_image_id、face_id、create_time、_id、_all、_source等字段命名。 Json字符串不校验重复性，自定义字段的key值长度范围为[1,36]，string类型的value长度范围为[1,256]，具体参见自定义字段。 |
响应消息
- 参数说明
参数名
参数类型
说明
face_set_info
Object
人脸库信息，详见FaceSetInfo。
调用失败时无此字段。
error_code
String
调用失败时的错误码，具体请参考错误码。
调用成功时无此字段。
error_msg
String
调用失败时的错误信息。
调用成功时无此字段。
示例
X-Auth-Token值获取方法请参见认证鉴权。
- 请求样例
POST https://{endpoint}/v1/{project_id}/face-sets Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT... Request Body: { "face_set_name": "test", "face_set_capacity": 100000, "external_fields" : { "timestamp" : { "type" : "long" }, "id" : { "type" : "string" }, "number" : { "type" : "integer" } } } - 响应样例
{ "face_set_info": { "face_number": 0, "face_set_id": "WYYOFIGb", "face_set_name": "test", "create_date": "2018-05-28 02:19:00", "face_set_capacity": 10000, "external_fields": { "timestamp" : { "type" : "long" }, "id" : { "type" : "string" }, "number" : { "type" : "integer" } } } } - 失败响应样例
{ "error_code": "FRS.0002", "error_msg": "The authentication token is abnormal." }
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
