人脸特效

最近更新时间：2024-04-03 16:01:45

我的收藏

本页目录：

功能描述
人脸特效支持人脸美颜、人脸性别变换、人脸年龄变化、人像分割的特效功能，适用于社交娱乐、广告营销、互动传播等场景。
功能
说明
人脸美颜
可用于自拍照片等人像美化场景，上传照片即可一键智能实现美白、磨皮、瘦脸、大眼、美型，支持自定义调整参数，帮助提升个人形象
人脸性别变换
用户上传一张人脸图片，基于人脸编辑与生成算法，输出一张人脸性别转换的图片。男变女可实现美颜、淡妆、加刘海和长发的效果；女变男可实现加胡须、变短发的效果
人脸年龄变化
用户上传一张人脸图片，基于人脸编辑与生成算法，输出一张人脸变老或变年轻的图片，支持实现人脸不同年龄的变化
人像分割
指对图片中的人体轮廓范围进行识别，将其与背景进行分离，返回分割后的二值图、灰度图、前景人像图。可应用于人像抠图、照片合成、人像特效等场景，极大提升工具效率
说明
本接口属于 GET 请求，为同步请求方式，需携带签名，具体签名设置请参见 请求签名。
人脸特效为付费服务，计费详情请查看 人脸特效费用，数据万象在每个账户首次产生该服务用量后，将发放一个用量为6000次，有效期为2个月的免费额度资源包，超出用量或资源包到期后将正常计费。
该功能目前仅提供 API 使用方式
﻿
授权说明
授权策略中 action 设置为 ci:FaceEffect 。查看所有 action。
服务开通
使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务。
使用限制
使用该接口时，请先确认相关限制条件。详情请参见 使用限制。
请求
请求示例
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-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
﻿
<Response>
  <ResultImage>base64编码的图片</ResultImage>
</Response>
﻿

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

参数名称	描述	类型	是否必选
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	是

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