文档首页 > > API参考> 人脸识别API(V1)> 人脸库资源管理> 创建人脸库

创建人脸库

分享
更新时间: 2020/07/28 GMT+08:00

功能介绍

创建用于存储人脸特征的人脸库。您最多可以创建10个人脸库,每个人脸库最大容量为10万个人脸特征。如有更大规格的需求请联系客服。

application/json请求的body中,请使用标准Json格式。

URI

  • URI格式
    POST /v1/{project_id}/face-sets
  • 参数说明

    参数名

    参数类型

    是否必选

    说明

    project_id

    String

    项目ID,获取方法请参见获取项目ID/账号名/AK/SK

请求消息

表1 请求参数

参数名

参数类型

是否必选

说明

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

    调用失败时的错误信息。

    调用成功时无此字段。

示例

  • 请求样例
    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."
    }

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问