功能描述
人脸特效,提供人脸美颜、人像变换、人像分割功能。
注意:
授权说明
服务开通
使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶。
使用该功能需提前通过控制台或接口开通 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.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
原图来自其他链接:
GET /?ci-process=face-effect&type=<type>&detect-url=<detect-url> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>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.1Authorization:q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=****************************************Host:bucket-1250000000.cos.ap-beijing.myqcloud.com
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 414641Date: Thu, 15 Jun 2017 12:37:29 GMTServer: tencent-imagex-cos-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhfMjc=<Response><ResultImage>base64编码的图片</ResultImage></Response>