人脸融合

最近更新时间:2019-07-24 16:34:48

1. 接口描述

接口请求域名: facefusion.tencentcloudapi.com 。

本接口用于人脸融合,用户上传人脸图片,获取与模板融合后的人脸图片。未发布的活动请求频率限制为1次/秒,已发布的活动请求频率限制50次/秒。如有需要提高活动的请求频率限制,请在控制台中申请。

  • 公共参数中的签名方式必须指定为V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。

默认接口请求频率限制:1500次/秒。

2. 输入参数

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

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:FaceFusion
Version String 公共参数,本接口取值:2018-12-01
Region String 公共参数,本接口不需要传递此参数。
ProjectId String 活动 ID,请在人脸融合控制台查看。
ModelId String 素材 ID,请在人脸融合控制台查看。
Image String 图片 base64 数据。请确保人脸为正脸,无旋转。若某些手机拍摄后人脸被旋转,请使用图片的 EXIF 信息对图片进行旋转处理;请勿在 base64 数据中包含头部,如“data:image/jpeg;base64,”。
RspImgType String 返回图像方式(url 或 base64) ,二选一。当前仅支持 url 方式,base64 方式后期开放。
PornDetect Integer 0表示不需要鉴黄,1表示需要鉴黄。2018年12月1号以前创建的活动默认值为0,其他情况默认值为1.
CelebrityIdentify Integer 0表示不需要鉴政,1表示需要鉴政。2018年12月1号以前创建的活动默认值为0,其他情况默认值为1。鉴政接口同时会对名人明星进行识别,您可以根据实际需要过滤。

3. 输出参数

参数名称 类型 描述
Image String RspImgType 为 url 时,返回结果的 url, RspImgType 为 base64 时返回 base64 数据。当前仅支持 url 方式,base64 方式后期开放。
ReviewResultSet Array of FuseFaceReviewResult 鉴黄鉴政结果
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 调用返回成功

输入示例

https://facefusion.tencentcloudapi.com/?Action=FaceFusion
&ProjectId=100646
&ModelId=qc_100646_154021_9
&RspImgType=url
&Image=base64_string
&<公共请求参数>

输出示例

{
  "Response": {
    "Image": "https://facefusion-1254418846.cos.ap-guangzhou.myqcloud.com/qc_100646_204857_1_1543312645513131155.jpg",
    "RequestId": "66676130-5588-4cdb-a81e-8bd3c99cea1f",
    "ReviewResultSet": [
      {
        "Category": "porn",
        "Code": 0,
        "CodeDescription": "ok",
        "Suggestion": "pass",
        "Confidence": 2.2541460566572e-05,
        "DetailSet": [
          {
            "Field": "porn",
            "Label": "porn",
            "Confidence": 1.9030628184424e-09,
            "Suggestion": "pass"
          }
        ]
      },
      {
        "Category": "politics",
        "Code": 0,
        "CodeDescription": "ok",
        "Suggestion": "pass",
        "Confidence": 0.71566122770309,
        "DetailSet": [
          {
            "Field": "体育",
            "Lable": "丁俊晖",
            "Confidence": 0.71566122770309,
            "Suggestion": "pass"
          }
        ]
      }
    ]
  }
}

示例2 调用返回失败

输入示例

https://facefusion.tencentcloudapi.com/?Action=FaceFusion
&ProjectId=100646
&ModelId=qc_100646_154021_9
&RspImgType=url
&Image=base64_string
&<公共请求参数>

输出示例

{
  "Response": {
    "Error": {
      "Code": "FailedOperation.FuseDetectNoFace",
      "Message": "未检测到人脸."
    },
    "RequestId": "8ae581fd-c25f-4a63-83b3-d9fcd97230c8"
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

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

命令行工具

6. 错误码

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

错误码 描述
FailedOperation.AddMaterialFail 素材添加失败。
FailedOperation.FuseBackendServerFault 人脸融合后端服务异常。
FailedOperation.FuseDetectNoFace 未检测到人脸。
FailedOperation.FuseFreqCtrl 操作太频繁,触发频控。
FailedOperation.FuseImageError 图像处理出错。
FailedOperation.FuseInnerError 服务内部错误。
FailedOperation.FuseMaterialNotAuth 素材未经过审核。
FailedOperation.FuseMaterialNotExist 素材不存在。
FailedOperation.FuseSavePhotoFail 保存结果图片出错。
FailedOperation.ParameterValueError 必填的参数字段或者值有误。
ResourcesSoldOut.ChargeStatusException 帐号已欠费。