人脸图片美颜

最近更新时间:2020-01-10 11:00:14

1. 接口描述

接口请求域名: fmu.tencentcloudapi.com 。

输入人脸图片,输出美颜后的人脸图片。

默认接口请求频率限制:20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:BeautifyPic。
Version String 公共参数,本接口取值:2019-12-13。
Region String 公共参数,详见产品支持的 地域列表
Image String 图片 base64 数据,base64 编码后大小不可超过5M。
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
Url String 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
Url、Image必须提供一个,如果都提供,只使用 Url。
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
非腾讯云存储的Url速度和稳定性可能受一定影响。
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
Whitening Integer 美白程度,取值范围[0,100]。0不美白,100代表最高程度。默认值30。
Smoothing Integer 磨皮程度,取值范围[0,100]。0不磨皮,100代表最高程度。默认值10。
FaceLifting Integer 瘦脸程度,取值范围[0,100]。0不瘦脸,100代表最高程度。默认值70。
EyeEnlarging Integer 大眼程度,取值范围[0,100]。0不大眼,100代表最高程度。默认值70。

3. 输出参数

参数名称 类型 描述
ResultImage String 处理后的图片 base64 数据。
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 调用成功示例

输入示例

https://fmu.tencentcloudapi.com/?Action=BeautifyPic
&Url=http://i2.sinaimg.cn/ty/nba/2015-07-05/U10236P6T12D7648505F44DT20150705114547.jpg
&Version=2019-12-13
&<公共请求参数>

输出示例

{
  "Response": {
    "ResultImage": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/wAARCAFuAiYDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqr...",
    "RequestId": "9cf173a5-4ae5-46fb-9898-6c876263770d"
  }
}

示例2 调用失败示例

输入示例

https://fmu.tencentcloudapi.com/?Action=BeautifyPic
&Url=IamNotAUrl
&Version=2019-12-13
&<公共请求参数>

输出示例

{
  "Response": {
    "Error": {
      "Code": "InvalidParameterValue.UrlIllegal",
      "Message": "URL格式不合法。"
    },
    "RequestId": "897d8a3d-6677-4c41-b647-f0a19a6dc13f"
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
FailedOperation.BeautifyFailed 图片美颜失败,请更换图片。
FailedOperation.ImageDecodeFailed 图片解码失败。
FailedOperation.ImageDownloadError 图片下载失败。
FailedOperation.ImageSizeExceed 图片数据太大。
FailedOperation.InnerError 服务内部错误,请重试。
FailedOperation.RequestEntityTooLarge 请求包体太大,建议在6M内(通常是参数中包括大的图片)。
FailedOperation.RequestTimeout 后端服务超时,请重试。
InvalidParameter.InvalidParameter 参数不合法。
InvalidParameter.NoFaceInPhoto 图片中没有人脸。