人脸美白美颜

本接口用于对人脸进行美白美颜

接口鉴权

接口地址

【POST】https://open-api.gaoding.com/api/call/facebeauty

请求头（request header）

字段	类型	是否必填	字段描述
app_id	string	是	应用ID，获取方式：应用列表 -> 应用详情 -> APP ID

请求体（request body）

字段	类型	是否必填	字段描述
url	string	二个必填一个优先级：url>file_base64	原图url，支持JPG、PNG格式仅保留1个月，请及时转储（无文件大小限制）
file_base64	string	二个必填一个优先级：url>file_base64	原图的base64码（最大支持3M文件）
result_type	string	否	结果返回类型：枚举值：url，base64 默认url
white_weight	float	否	美白程度, 范围：0-1（0不美白，1完全美白）默认0.5
smooth_weight	float	否	磨皮程度(0-1，0为不磨皮，1为最大磨皮程度）默认0.5
use_global	int	否	是否美白整张照片0–否 1–是（输入为0时，图片内必须带人脸，否则返回错误代码：-10003，找不到人脸错误）

请求体示例（url）：

{
  "url": "https://matting-batch.dancf.com/cloths/20220825_173220_gaoding_imagematting_humanhead.jpg",
  "white_weight": 1,
  "smooth_weight": 1,
  "use_global": 1
}

请求体示例（base64）：

{
	 "file_base64":"图片的base64编码",
   "white_weight": 1,
   "smooth_weight": 1,
   "use_global": 1
}

响应体（response body）

字段	类型	是否必存在	字段描述
result_url	string	二者必返回一个	结果图url，返回PNG格式，仅保留1个月，请及时转储
result	string	二者必返回一个	结果图的Base64编码
code	int	是	状态码，0为正常
message	string	是	错误信息

响应示例1（模拟正常请求：url入参）：

http_status：200

response body：

{
  "code": 0,
  "message": "success",
  "result_url": "https://matting-batch.dancf.com/dev/api/6c30f3490fcb8a53-20220825185315073.png"
}

响应示例2（模拟正常请求：base64入参）：

http_status：200

response body：

{
  "code": 0,
  "message": "success",
  "result": "图片的base64编码"
}

响应示例3（模拟参数非法请求）：

http_status：400

response body：

{
    "code": -10010,
    "message": "/mnt/image/inpaint/null.png"
}

错误码

HTTP状态码	业务错误码	含义
400	-10003	参数非法，非人脸或人脸不全情况
400	-10001	下载失败，可能是用户传的url非法，或者网络异常等原因导致下载失败
400	-10002	解码图片失败，可能是某些格式比较特殊的图片暂时还不支持，或者图片url下载下来根本不是图像数据
400	-10007	图片数据过大，无法处理
500		服务器错误
422		接口入参错误

响应示例2（模拟正常请求：base64入参）：

响应示例3（模拟参数非法请求）：

错误码