简介
本文档提供关于人脸特效的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
人脸特效 |
人脸特效
功能说明
人脸特效，提供人脸美颜、人像变换、人像分割功能。
示例代码
def cos_ai_face_effect():# 人脸特效# demo地址：https://github.com/tencentyun/cos-python-sdk-v5/blob/master/demo/ai_recognition_demo.py#L164response, data = client.cos_ai_face_effect(Bucket=bucket_name, ObjectKey="relian.jpeg", # DetectUrl="https://test-125000000.cos.ap-chongqing.myqcloud.com/test.jpeg", Type="face-beautify", Whitening=30, Smoothing=10, FaceLifting=70, EyeEnlarging=70,)print(response)print(data)return response, data
参数说明
调用 cos_ai_face_effect 函数，具体请求参数如下：
参数名称 | 参数描述 | 类型 | 是否必填 |
Bucket | 存储桶名称 | String | 是 |
ObjectKey | 设置对象名称。ObjectKey与DetectUrl必选一个 | String | 否 |
DetectUrl | 您可以通过填写 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。ObjectKey与DetectUrl必选一个 | 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 为响应头，data 为人脸特效结果，数据类型都为 dict。
response内容
响应体data
响应体具体数据内容如下：
参数名称 | 参数描述 | 类型 |
ResultImage | 处理后的图片 base64 数据 | String |
ResultMask | 人像分割输出参数，一个通过 Base64 编码的文件，解码后文件由 Float 型浮点数组成。这些浮点数代表原图从左上角开始的每一行的每一个像素点，每一个浮点数的值是原图相应像素点位于人体轮廓内的置信度（0-1）转化的灰度值（0-255） | String |
