增加人脸

1. 接口描述

接口请求域名： iai.tencentcloudapi.com 。

将一组人脸图片添加到一个人员中。一个人员最多允许包含 5 张图片。若该人员存在多个人员库中，所有人员库中该人员图片均会增加。

• 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 错误示例

已有人员最多再新增4张人脸图片

输入示例

https://iai.tencentcloudapi.com/?Action=CreateFace
&PersonId=1001
&Urls.0=http://test.image.myqcloud.com/testB.jpg
&Urls.1=http://test.image.myqcloud.com/testC.jpg
&Urls.2=http://test.image.myqcloud.com/testD.jpg
&Urls.3=http://test.image.myqcloud.com/testE.jpg
&Urls.4=http://test.image.myqcloud.com/testF.jpg
&<公共请求参数>

输出示例

{
    "Response": {
        "Error": {
            "Code": "InvalidParameterValue.UploadFaceNumExceed",
            "Message": "一次最多上传四张人脸。"
        },
        "RequestId": "44506f79-2191-49bc-997b-748a566d781c"
    }
}

示例2 增加人脸接口

将一组人脸图片添加到一个人员中

输入示例

https://iai.tencentcloudapi.com/?Action=CreateFace
&PersonId=1001
&Urls.0=http://test.image.myqcloud.com/testA.jpg
&<公共请求参数>

输出示例

{
    "Response": {
        "SucFaceNum": 1,
        "SucFaceIds": [
            "2875186538564559728"
        ],
        "RetCode": [
            0
        ],
        "SucIndexes": [
            0
        ],
        "SucFaceRects": [
            {
                "X": 135,
                "Y": 42,
                "Width": 98,
                "Height": 136
            }
        ],
        "FaceModelVersion": "2.0",
        "RequestId": "07d63403-a199-4bbe-b9e0-692356ac738d"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。