模特换肤生成任务提交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仅支持“服装”品类的自动分割和保留，暂不支持其他指定品类商品。

Java

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。用于后续的请求结果查询。

返回示例

Java

{
  "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，入群联系我们。