人脸特效

最近更新时间:2024-10-28 16:06:21

我的收藏

简介

本文档提供关于人脸特效的相关 API 概览以及 SDK 示例代码。
API
操作描述
人脸特效,提供人脸美颜、人像变换、人像分割功能。

人脸特效

功能说明

人脸特效,提供人脸美颜、人像变换、人像分割功能。

示例代码

<?php

require dirname(__FILE__, 2) . '/vendor/autoload.php';

$secretId = "SECRETID"; //替换为用户的 secretId,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capi
$secretKey = "SECRETKEY"; //替换为用户的 secretKey,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capi
$region = "ap-beijing"; //替换为用户的 region,已创建桶归属的region可以在控制台查看,https://console.cloud.tencent.com/cos5/bucket
$cosClient = new Qcloud\\Cos\\Client(
array(
'region' => $region,
'scheme' => 'https', // 审核时必须为https
'credentials'=> array(
'secretId' => $secretId ,
'secretKey' => $secretKey)));
try {
//人脸特效,提供人脸美颜、人像变换、人像分割功能
$result = $cosClient->ImageFaceEffect(array(
'Bucket' => 'test-1250000000', //存储桶名称,由BucketName-Appid 组成,可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket
'Key' => 'folder/image.jpg', // 对象文件名,例如 folder/document.jpg
'Headers' => array(
'Content-Type' => 'application/xml',
),
'type' => 'face-segmentation', // 人脸特效类型,人脸美颜:face-beautify;人脸性别转换:face-gender-transformation;人脸年龄变化:face-age-transformation;人像分割:face-segmentation
'whitening' => 30, // type为face-beautify时生效,美白程度,取值范围[0,100]。0不美白,100代表最高程度。默认值30
'smoothing' => 10, // type为face-beautify时生效,磨皮程度,取值范围[0,100]。0不磨皮,100代表最高程度。默认值10
'faceLifting' => 70, // type为face-beautify时生效,瘦脸程度,取值范围[0,100]。0不瘦脸,100代表最高程度。默认值70
'eyeEnlarging' => 70, // type为face-beautify时生效,大眼程度,取值范围[0,100]。0不大眼,100代表最高程度。默认值70
'gender' => 1, // type为face-gender-transformation时生效,选择转换方向,0:男变女,1:女变男。无默认值,为必选项。限制:仅对图片中面积最大的人脸进行转换。
'age' => 18, // type为face-age-transformation时生效,变化到的人脸年龄,[10,80]。无默认值,为必选项。限制:仅对图片中面积最大的人脸进行转换。

));
// 请求成功
print_r($result);
} catch (\\Exception $e) {
// 请求失败
echo($e);
}

参数说明

请求参数

参数名称
参数描述
类型
是否必填
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。
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
Bucket
存储桶名称。
String
Key
对象文件名,例如 folder/document.jpg。
String

返回参数说明

具体返回参数,请参见 人脸特效接口。