人脸比对 功能介绍 人脸比对是将两个人脸进行比对，来判断是否为同一个人，返回比对置信度。如果传入的图片中包含多个人脸，选取最大的人脸进行比对。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 约束限制： 人脸比对输入的两张图片总大小。 只支持识别JPG、PNG、JPEG、BMP格式的图片。

查看更多 →

删除人脸库 功能介绍 删除人脸库以及其中所有的人脸。人脸库数据为用户隐私数据，该数据无备份，删除时请谨慎操作。 前提条件： 请确保您已开通人脸搜索服务。 调试 您可以在 API Explorer 中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

查看更多 →

添加人脸 功能介绍 添加人脸到人脸库中。将单张图片中的人脸添加至人脸库中，支持添加最大人脸或所有人脸。 前提条件： 请确保您已开通人脸搜索服务。 约束限制： 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。

查看更多 →

批量删除人脸 功能介绍 自定义筛选条件，批量删除人脸库中的符合指定条件的多张人脸。 前提条件： 请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI

查看更多 →

创建照片建模任务 功能介绍 该接口用于创建风格化照片建模任务。使用BASE64编码照片，通过JSON格式上传，生成风格化数字人模型。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/digital-human/stylized/picture-modelings-by-json

查看更多 →

查询照片检测任务详情 功能介绍 该接口用于查询照片检测任务详情。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/photo-detection/{job_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String

查看更多 →

人脸搜索 功能介绍 人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸，并返回相应的置信度。如果图片中包含多个人脸，选取图片中检测到的最大尺寸人脸作为检索的输入。 支持传入图片或者faceID进行人脸搜索。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。

查看更多 →

查询人脸库 功能介绍 查询人脸库当前的状态。 前提条件： 请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/{projec

查看更多 →

有哪些途径可以使用人脸识别的API 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。 编码 通过编码调用接口，组装请求消息，并发送处理请求消息。

查看更多 →

说明 01 请上传您的照片 人像照片 单击“查看示范”，在弹出的“上传照片要求”对话框中，查看照片拍摄要求。 请严格按照要求拍摄并上传照片。照片格式必须为JPG、JPEG、PNG、WEBP，大小不超过16MB，照片比例推荐16:9或9:16。 视频名称 使用照片人像合成视频名称。 02

查看更多 →

开始人脸检测 表1 开启人脸检测 REST URL格式 访问方法 URI POST /v1/ai/face-detection/start 接口功能 开始人脸检测功能 接口说明 本接口调用后，开启人脸检测 响应数据 参见表2、表3 参数 参数名称 可选/必选/条件必选 参数类型 位置

查看更多 →

云上人脸提取 创建云上人脸提取作业 查询作业列表 查询单个作业 删除作业 父主题： 云上服务API

查看更多 →

停止人脸检测 表1 停止人脸检测 REST URL格式 访问方法 URI POST /v1/ai/face-detection/stop 接口功能 停止人脸检测功能 接口说明 本接口调用后，人脸检测功能停止 响应数据 参见表2、表3 参数 参数名称 可选/必选/条件必选 参数类型

查看更多 →

人脸资源管理 添加人脸 查询人脸 更新人脸 删除人脸 批量删除人脸 父主题： API

查看更多 →

创建照片建模任务 功能介绍 该接口用于创建风格化照片建模任务。通过上传照片，生成风格化数字人模型。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/digital-human/stylized/picture-modelings 表1 路径参数

查看更多 →

用户自定义请求ID 是 唯一标识此次请求的ID，用户自定义，不超过64位。 姓名 是 被验证人的姓名。 身份证号码 是 被验证人的身份证号码。 人脸照片 是 人像图像数据，使用base64编码。要求base64编码后大小不超过4MB。图像各边的像素大小在300到4000px之间，支持JPG格式。

查看更多 →

照片数字人视频制作管理 创建照片分身数字人视频制作任务 查询照片分身数字人视频制作任务详情 取消等待中的照片分身数字人视频制作任务 创建照片检测任务 查询照片检测任务详情 父主题： 分身视频制作

查看更多 →

times 人脸识别 失败调用次数 该指标用于统计状态码为5xx的调用API失败的次数。 单位：次（times）。 ≥ 0 times 人脸识别 平均时延 该指标用于统计API的平均时延。 单位：毫秒（ms）。 ≥ 0 ms 人脸识别 人脸数量 该指标用于统计人脸库的人脸数量。 建

查看更多 →

人脸搜索是否需要使用OBS服务 人脸搜索是否需要使用OBS服务 人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸。在使用人脸搜索时，需创建人脸库（使用人脸库，也以开通人脸搜索服务为前提）。人脸库创建在华为云 对象存储服务 （OBS）中，您可以参考API文档“人脸库资

查看更多 →

Programming Interface，应用程序编程接口）的方式提供人脸识别能力，用户调用API接口需要具备一定的编程开发能力，人脸识别后返回的结果为JSON格式，用户需要通过编程来处理识别结果。使用前，请登录人脸识别服务控制台开通服务。 您可以根据以下方式的介绍选择合适的使用方式：

查看更多 →

photoFileSample String 照片样例：存FILE_ID清单，用逗号隔开 photoFlag String 是否允许拍照，Y/N projectNo String 项目编码 tenantName String 租户名 maxPhoto Integer 最多照片数量 createdBy Long

查看更多 →