中文版
快速试用控制台

模特换肤生成任务提交API调用说明

模特换肤生成任务提交

GET/POST /ai/virtual/model/generation/batch

模特换肤产品可以自动保留模特图中的服装区域，智能匹配模特类型，生成跨国别、多样化的模特，体现商品的最佳穿戴效果。该产品可针对跨境市场投放本土化内容，精准捕捉用户喜好，并降低拍摄成本。

注：该接口是异步接口，您需要先提交任务，获取任务id后，调用结果查询接口获取生成结果。当前API为第一步任务提交API。

请求参数

参数参数类型必填描述

requestParams

Object[]

是

请求参数

imageUrl

String

否

模特图片URL。

与imageBase64不能同时为空。如果同时存在imageUrl和imageBase64，优先取 Base64。

图片尺寸应该大于512*512像素，小于3000*3000像素。

imageBase64

String

否

模特图片的Base64编码。

与imageUrl不能同时为空。如果同时存在imageUrl和imageBase64，优先取 Base64。

图片尺寸应该大于512*512像素，小于3000*3000像素。

imageStyle

String

是

指定传入图像的模特内容类型，如真人模特、完整人台、不完整人台等。目前暂时只支持真人模特图。取值范围：

realPhoto：传入真人模特图。

示例值：realPhoto

model

String

是

指定需要生成的模特。目前可支持四种不同模特的选择。取值范围：示例值：universal_model_

universal_model_1：

universal_model_2：

universal_model_3：

universal_model_4：

示例值: universal_model_1

gender

String

否

指定需要生成的模特性别。如果不设置，默认使用算法自动识别结果。取值范围：

MALE：男性

FEMALE：女性

示例值：MALE

age

String

否

指定需要生成的模特年龄段。如果不设置，默认使用算法自动识别结果。取值范围：

OLD_AGE：老年，约60岁以上

MIDDLE_AGE：中年，约30-50岁

YOUTH：青年，约20-30岁

示例值：YOUTH

maskKeepbg

Boolean

否

指定是否保留原图的背景。如果不设置，默认保持原图背景不变。取值范围：

true：保持背景不变，无需填入bgStyle参数。

false：更换背景，必需指定bgStyle参数。

示例值：true

bgStyle

String

否

指定需要生成的背景风格。在选择背景更换（maskKeepbg=false）时，需要填入该参数。目前可支持四种场景的选择，取值范围：

studio：棚拍

room：室内

European_street：街景

beach：海滩

示例值：studio

count

Number

否

指定期望生成的图片数量。单次任务最多生成四张。如果不设置，默认生成2张。

取值范围：1-4

示例值：2

dimension

Number

否

指定期望生成的图片尺寸。生成图片会保持原图比例不变，最短边以传入值为准。如果不设置，默认生成尺寸为768。

取值范围：512-2048

示例值：768

请求示例

输入限制：

  • 图像格式：JPEG、JPG、PNG、BMP、WEBP。

  • 图像大小：不超过 4 MB。

  • 图像分辨率：输入图片尺寸大于 512×512 像素，小于 3000×3000 像素。

  • 品类范围：目前模特换肤API仅支持“服装”品类的自动分割和保留，暂不支持其他指定品类商品。

IopClient client = new IopClient(url, appkey, appSecret);
IopRequest request = new IopRequest();
request.setApiName("/ai/virtual/model/generation/batch");
request.addApiParameter("bgStyle", "room");
request.addApiParameter("model", "WHITE");
request.addApiParameter("gender", "FEMALE");
request.addApiParameter("count", "2");
request.addApiParameter("imageStyle", "realPhoto");
request.addApiParameter("imageBase64", "");
request.addApiParameter("imageUrl", "https://ae01.alicdn.com/kf/H873d9e029746449ca21737fcf595b781X.jpg");
request.addApiParameter("maskKeepBg", "true");
request.addApiParameter("dimension", "768");
request.addApiParameter("age", "YOUTH");
IopResponse response = client.execute(request);
System.out.println(response.getBody());
Thread.sleep(10);

响应参数

参数参数参数类型Description

requestId

String

唯一的请求ID。用于排查问题。

success

Boolean

返回的请求状态，代表请求是否成功。

resCode

Number

返回的结果码，其中200代表成功，详细错误码请参考错误码列表。

resMessage

String

返回的请求信息。

data

Object

返回的json结果数据。

result

Object

返回的结果数据。

taskId

String

唯一的任务ID。用于后续的请求结果查询。

返回示例

{
  "data": {
    "taskId": "4dcfa662-d5b3-48d5-842e-a87f70ac1522"
  },
  "requestId": "2141111917193839073095037e1893",
  "success": true,
  "resCode": 200,
  "resMessage": "success",
  "code": "0",
  "request_id": "212a664f17193839073127402",
  "_trace_id_": "2141111917193839073095037e1893"
}

错误码

错误码错误信息描述

500

system error

System error.服务器内部错误

501

rate limit exceed

当前接口已达到限流上限,请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们增加当前限制值。

700

invalid input

输入参数的格式不符合要求，resMessage 将返回详细的不符合要求的字段。

801

model failed

内部调用异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们进行故障排除。

1000

content has sensitive data, please try other input

内容包含敏感数据，无法处理，请尝试其他输入。

1001

content control failed, please retry

风控服务运行异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。

1002

content risk filter failed, please contact us

风控服务运行异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。

Previous模特换肤Next模特换肤生成结果获取API调用说明

Last updated