创建人脸库

功能介绍

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

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

URI

• URI格式

  POST /v1/{project_id}/face-sets

• 参数说明

  参数名	参数类型	是否必选	说明
  project_id	String	是	项目ID，获取方法请参见获取项目ID/账号名/AK/SK。

请求消息

响应消息

• 参数说明

  参数名	参数类型	说明
  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."
  }

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。