身体美型-阿里云帮助中心

功能描述

可以对人物图像中头部以外区域（脖子、躯干和四肢等）进行优化，使其呈现出更符合大众审美的体态，让人体看起来更高挑、苗条和精致，同时保持身体线条流畅、弧度自然、力度适中。支持多人和不同体态（全身、半身）的处理。

如下图所示。

原始图像
美型效果

应用场景

婚纱写真：对婚纱写真照片进行批量自动化人体美型处理，缩减修图周期，快速提供客户选片。
移动App：输入一张人像照片，通过调用身体美型算法能力消除赘肉，打造完美身材。

特色优势

精准刻画：通过深度学习算法，精准分析人体姿态和胖瘦信息，实现完美自然身体美型效果。
支持多角度姿态：不论何种姿态角度，身体美型算法均能智能判别处理。
支持多人：支持同图中多个人像的身体美型。

前提条件

请确保您已开通人脸人体服务，若未开通服务请立即开通。

输入限制

图像格式：JPEG、JPG、PNG、BMP。
图像大小：不超过3 MB。
图像分辨率：大于128×128像素，小于5000×5000像素。
URL地址中不能包含中文字符。

说明当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见图片缩放。

注意事项

建议您在集成使用平台该能力的应用界面提供滤镜的提示，并提供“关闭滤镜”的选项。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	RetouchBody	系统规定参数。取值：RetouchBody。
ImageURL	String	是	https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/photo-1562956335-14faa1a9aeeb.jpeg	图像URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。
SlimDegree	Float	是	1.0	液化力度，取值范围为[-1.0,1.0]。正数表示变瘦，负数表示变壮。
LengthenDegree	Float	是	1.0	拉伸力度，取值范围为[0,1.0]，1.0为标准值，小于0不做拉伸。

返回数据


名称	类型	示例值	描述
Data	Object		返回的数据内容。
ImageURL	String	http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/body-beautifier/C0AFBD40-C705-52EB-90F5-37FA2FA62880_468d_20210926-075355.jpg?Expires=1632644635&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp**&Signature=O7M9ITFAExDmwnZ86BFDVGeE%2BZ**	美型后图像的URL地址。
RequestId	String	C0AFBD40-C705-52EB-90F5-37FA2FA62880	请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=RetouchBody
&ImageURL=https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/photo-1562956335-14faa1a9aeeb.jpeg
&SlimDegree=1.0
&LengthenDegree=1.0
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RetouchBodyResponse>
    <Data>
        <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/body-beautifier/C0AFBD40-C705-52EB-90F5-37FA2FA62880_468d_20210926-075355.jpg?Expires=1632644635&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=O7M9ITFAExDmwnZ86BFDVGeE%2BZ****</ImageURL>
    </Data>
    <RequestId>C0AFBD40-C705-52EB-90F5-37FA2FA62880</RequestId>
</RetouchBodyResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Data" : {
    "ImageURL" : "http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/body-beautifier/C0AFBD40-C705-52EB-90F5-37FA2FA62880_468d_20210926-075355.jpg?Expires=1632644635&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=O7M9ITFAExDmwnZ86BFDVGeE%2BZ****"
  },
  "RequestId" : "C0AFBD40-C705-52EB-90F5-37FA2FA62880"
}

错误码

关于身体美型的错误码，详情请参见常见错误码。

SDK参考

阿里云视觉AI能力支持使用SDK调用，具体可参见SDK总览下载安装。

安全声明

请确保上传的图片或文件来源符合相应的法律法规。
通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。