人脸特效

最近更新时间:2024-04-09 15:54:34

我的收藏

功能描述

人脸特效,提供人脸美颜、人像变换、人像分割功能。
注意:
本接口属于 GET 请求,为同步请求方式,需携带签名,具体签名设置请参见 请求签名

授权说明

通过子账号使用时,需要授予 ci:FaceEffect权限,详情请参见 数据万象 action

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务

使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制
图片 base64 编码后大小不可超过5M。支持 PNG、JPG、JPEG、BMP,不支持 GIF 图片。
当 type 为 face-segmentation 时,图片分辨率须小于2000*2000。

费用说明

该接口为付费服务,产生的费用将由数据万象收取,详细计费说明可参见 内容识别费用


请求

请求示例

原图存储在COS:
GET /<ObjectKey>?ci-process=face-effect&type=<type> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
原图来自其他链接:
GET /?ci-process=face-effect&type=<type>&detect-url=<detect-url> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
注意:
Authorization: Auth String ,详情请参见 请求签名 文档。

请求参数

参数名称
是否必选
类型
描述
ObjectKey
String
对象文件名,例如 folder/document.pdf
ci-process
String
万象处理能力,人脸特效固定为 face-effect
detect-url
String
您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时,后台会默认处理 ObjectKey ,填写了 detect-url 时,后台会处理 detect-url 链接,无需再填写 ObjectKey。
detect-url 示例:http://www.example.com/abc.jpg ,需要进行 UrlEncode,处理后为http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg
type
String
人脸特效类型,人脸美颜:face-beautify;人脸性别转换:face-gender-transformation;人脸年龄变化:face-age-transformation;人像分割:face-segmentation
whitening
Integer
type 为 face-beautify 时生效,美白程度,取值范围[0,100]。0不美白,100代表最高程度。默认值30
smoothing
Integer
type 为 face-beautify 时生效,磨皮程度,取值范围[0,100]。0不磨皮,100代表最高程度。默认值10
faceLifting
Integer
type 为 face-beautify 时生效,瘦脸程度,取值范围[0,100]。0不瘦脸,100代表最高程度。默认值70
eyeEnlarging
Integer
type 为 face-beautify 时生效,大眼程度,取值范围[0,100]。0不大眼,100代表最高程度。默认值70
gender
Integer
type 为 face-gender-transformation 时生效,选择转换方向,0:男变女,1:女变男。无默认值,为必选项。限制:仅对图片中面积最大的人脸进行转换。
age
Integer
type 为 face-age-transformation 时生效,变化到的人脸年龄,[10,80]。无默认值,为必选项。限制:仅对图片中面积最大的人脸进行转换。

请求头

公共头部
该请求操作的实现使用公共请求头,了解公共请求头详情请参阅 公共请求头部 文档。
非公共头部
该请求操作无特殊的请求头部信息。

请求体

该请求无请求体。

响应

响应头

公共响应头
该响应包含公共响应头,了解公共响应头详情请参阅 公共响应头部 文档。
特有响应头
该响应无特殊的响应头。

响应体

该响应体返回为 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=AKIDZfbOAo7cllgPvF9cXFrJD0**********&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0ea057
Host:bucket-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-cos-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhfMjc=

<Response>
<ResultImage>
base64编码的图片
</ResultImage>
</Response>