API 文档

人脸特效

最近更新时间:2021-07-06 15:06:57

功能描述

人脸特效支持人脸美颜、人脸性别变换、人脸年龄变化、人像分割的特效功能,适用于社交娱乐、广告营销、互动传播等场景。

功能 说明
人脸美颜 可用于自拍照片等人像美化场景,上传照片即可一键智能实现美白、磨皮、瘦脸、大眼、美型,支持自定义调整参数,帮助提升个人形象
人脸性别变换 用户上传一张人脸图片,基于人脸编辑与生成算法,输出一张人脸性别转换的图片。男变女可实现美颜、淡妆、加刘海和长发的效果;女变男可实现加胡须、变短发的效果
人脸年龄变化 用户上传一张人脸图片,基于人脸编辑与生成算法,输出一张人脸变老或变年轻的图片,支持实现人脸不同年龄的变化
人像分割 指对图片中的人体轮廓范围进行识别,将其与背景进行分离,返回分割后的二值图、灰度图、前景人像图。可应用于人像抠图、照片合成、人像特效等场景,极大提升工具效率
说明:

  • 当前人脸特效的图片限制为:图片 base64 编码后大小不可超过5MB。支持 PNG、JPG、JPEG、BMP 格式,不支持 GIF 图片。当使用人像分割时,图片分辨率须小于2000 × 2000px。
  • 人脸特效为付费服务,计费详情请查看 内容识别费用,每个账号每月有3000次的免费体验额度,超出后将正常计费。
  • 该功能目前仅提供 API 使用方式。

请求

请求示例

GET /<ObjectKey>?ci-process=face-effect&type=<type> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明:

Authorization: Auth String (详情请参见 请求签名 文档)。

请求参数

参数名称 描述 类型 是否必选
ObjectKey 对象文件名,例如:folder/document.jpg String
ci-process 数据万象处理能力,人脸特效固定为 face-effect String
type 人脸特效类型。人脸美颜:face-beautify;人脸性别转换:face-gender-transformation;人脸年龄变化:face-age-transformation;人像分割:face-segmentation String
whitening type 为 face-beautify 时生效,美白程度,取值范围[0,100]。0表示不美白,100表示最高程度。默认值30 Integer
smoothing type 为 face-beautify 时生效,磨皮程度,取值范围[0,100]。0表示不磨皮,100表示最高程度。默认值10 Integer
faceLifting type 为 face-beautify 时生效,瘦脸程度,取值范围[0,100]。0表示不瘦脸,100表示最高程度。默认值70 Integer
eyeEnlarging type 为 face-beautify 时生效,大眼程度,取值范围[0,100]。0表示不大眼,100表示最高程度。默认值70 Integer
gender type 为 face-gender-transformation 时生效,选择转换方向,0表示男变女,1表示女变男。无默认值。注意:仅对图片中面积最大的人脸进行转换 Integer
age type 为 face-age-transformation 时生效,变化到的人脸年龄,范围为[10,80],无默认值。注意:仅对图片中面积最大的人脸进行转换 Integer

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

该请求无请求体。

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:

<Response>
<ResultImage>base64编码的图片</ResultImage>
<ResultMask>base64编码的文件</ResultMask>
</Response>

具体的数据内容如下:

节点名称(关键字) 父节点 描述 类型
Response 保存结果的容器 Container

Response 的内容:

节点名称(关键字) 父节点 描述 类型
ResultImage Response 处理后的图片 base64 数据 String
ResultMask Response 人像分割输出参数,一个通过 Base64 编码的文件,解码后文件由 Float 型浮点数组成。这些浮点数代表原图从左上角开始的每一行的每一个像素点,每一个浮点数的值是原图相应像素点位于人体轮廓内的置信度(0-1)转化的灰度值(0-255) String

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。

实际案例

请求

GET /test.jpg?ci-process=face-effect&type=face-beautify&whitening=70&smoothing=80&faceLifting=70&eyeEnlarging=70 HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 414641
Date: Thu, 15 Jun 2017 12:37:29 GMT
Server: tencent-image
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
<Response>
<ResultImage>base64编码的图片</ResultImage>
</Response>
目录