文档首页/ 人脸识别服务 FRS/ API参考/ API/ 人脸资源管理/ 更新人脸
更新时间：2024-06-12 GMT+08:00
查看PDF

更新人脸

功能介绍

根据人脸ID（face_id）更新单张人脸信息。

前提条件：

请确保您已开通人脸识别服务，具体操作方法请参见申请服务。

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

URI

PUT /v2/{project_id}/face-sets/{face_set_name}/faces

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

face_set_name

String

是

人脸库名称。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，响应消息头中X-Subject-Token的值即为Token。

Content-Type

是

String

发送的实体的MIME类型，参数值为“application/json”。
表3 请求Body参数

参数名

参数类型

是否必选

说明

face_id

String

是

人脸ID，由系统内部生成的唯一ID。

external_image_id

String

否

用户指定的图片外部ID，与当前图像绑定。用户没提供，系统会生成一个。该ID长度范围为1～36位，可以包含字母、数字、中划线或者下划线，不包含其他的特殊字符。

这里是待修改的参数，external_image_id和external_fields至少选一个。

external_fields

Object

否

自定义字段的key值长度范围为[1,36]，string类型的value长度范围为[1,256]，具体参见自定义字段。

这里是待修改的参数，external_image_id和external_fields至少选一个。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

face_number

Integer

更新的人脸数量。 调用失败时无此字段。

face_set_id

String

人脸库ID。 调用失败时无此字段。

face_set_name

String

人脸库名称。 调用失败时无此字段。

状态码： 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

调用失败时的错误码。 调用成功时无此字段。

error_msg

String

调用失败时的错误信息。 调用成功时无此字段。

请求示例

X-Auth-Token值获取方法请参见认证鉴权。

  • 请求样例 
    PUT https://{endpoint}/v2/{project_id}/face-sets/showFaceSet/faces
Request Header:
Content-Type: application/json
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...

Request Body:
{
  "face_id": "iexEBb6t", 
  "external_image_id": "imageID",
  "external_fields": {
     "timestamp": 12,
     "id": "300018629384756"
  }
}

响应示例

状态码：200

成功响应样例 
{
  "face_number": 1,
  "face_set_id": "T785tx1N",
  "face_set_name": "showFaceSet"
}

状态码：400

失败响应样例 
{
  "error_code": "FRS.0303",
  "error_msg": "The face id is not exist, checkout your input."
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 人脸资源管理