AddFaceEntity_视觉智能开放平台-人脸人体_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

功能描述

添加人脸样本能力用于向人脸数据库中添加人脸样本数据。人脸样本数据是用来标识用户的唯一性,如用户 ID、员工 ID 等。

说明
  • 您可以进入在线咨询获取在线人工帮助。
    • 阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

    接入指引

    1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。
    2. 开通能力:请确保您已开通人脸人体服务,若未开通服务请立即开通
    注意 本能力支持企业或个人认证用户开通。更多实名认证操作信息,请参见[实名认证](https://help.aliyun.com/knowledge_list/37170.html)。
    1. 创建 AccessKey:请确保您已创建 AccessKey,如果您使用的是子账号 AccessKey,您需要给子账号赋予 AliyunVIAPIFullAccess 权限,具体操作,请参见 RAM 授权

    2. 前提条件:已通过创建人脸数据库(CreateFaceDb)接口创建了数据库名称(DbName)。

    3. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及 SDK 依赖信息,也可以下载完整的工程。

    4. 开发接入步骤:

    • SDK 总览中选择您要接入使用的 SDK 语言。
    • 在对应语言的 SDK 文档中找到 AI 类目为人脸人体(facebody)的 SDK 包进行安装。
    • 参考文档中提供的示例代码进行适当修改后调用。
    1. 示例代码:该能力常用语言的示例代码,请参见添加人脸样本示例代码

    2. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。

    限制说明

    • 每个人脸数据库支持最高 5 万人脸特征,暂不支持扩容。人脸样本和标签组合为一个人脸特征。
    • 每个人脸样本支持添加最多 10 个标签数据,暂不支持扩容。
    • 添加人脸样本接口提交任务并发默认为 2QPS。

    计费说明

    添加人脸样本能力可免费调用。

    流控信息

    当前云产品API请求速率暂未透出。

    授权信息

    如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

    具体说明如下:展开详情

    操作访问级别资源类型条件关键字关联操作
    viapi-facebody:AddFaceEntity
    Create
    全部资源
    *

    请求参数

    字段名称字段详情
    DbNamestring

    数据库名称。

    示例值:default参考取值来源:
      ListFaceDbs
    EntityIdstring

    实体 ID,可以包含数字、字母和下划线。

    示例值:mm2
    Labelsstring

    输入标签,最多可以添加 10 个标签,具体格式要求如下:展开详情

    示例值:鹿班

    返回参数

    字段名称字段详情
    RequestIdstring

    请求 ID。

    示例值:DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2

    返回说明

    SDK 参考

    阿里云视觉 AI 人脸人体类目下的添加人脸样本能力推荐使用 SDK 调用,支持多种编程语言,调用时请选择 AI 类目为人脸人体(facebody)的 SDK 包,文件参数通过 SDK 调用可支持本地文件及任意 URL,具体可参见 SDK 总览

    示例代码

    该能力常用语言的示例代码,请参见添加人脸样本示例代码

    返回示例

    错误码

    全局错误码
    HTTP 状态码错误码错误信息操作
    400
    ParameterError
    The parameter is invalid. Please check again.诊断
    403
    AuthFailed
    An error occurred while performing authorization. Please check your RAM configuration.诊断
    408
    Timeout
    The request has timed out.诊断
    503
    ServiceUnavailable
    The service is unavailable.诊断

    变更历史

    暂无变更历史

    相关示例

    人脸数据库的创建、人脸样本的新增、为人脸样本的添加图片以及测试人脸比对(1:N,1:1)
    2021-02-15