lianfan.huiwa.task.image.submit (批量提交生图任务)

批量提交生图任务

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
batch_gen_img_top_req BatchGenImgTopReq 必须 请求接口的参数,目前支持界面上的平铺图上身、固定姿势、自由姿势等3种生图模式
  • batch_gen_image_request
  • BatchGenImageRequest
  • 必须
  • 业务生图的参数
  • gen_image_requests
  • GenImageRequest []
  • 必须
  • 生图请求
  • 生图请求,目前仅支持一次一个请求
  • └ pass_through
  • String
  • 可选
  • {}
  • 扩展字段,业务透传给绘蛙,在查询的时候开发者可以使用这些参数
  • scene_group
  • GenImageSceneGroupReq
  • 必须
  • 参考图参数,一组参考图,对应绘蛙界面的参考图选项
  • └ image_count
  • Number
  • 必须
  • 1
  • 每张参考图的生图数量
  • scenes
  • GenImageSceneReq []
  • 必须
  • {}
  • 每张参考图的参数
  • └ scene_id
  • String
  • 必须
  • 1
  • 参考图id,用户自己训练或者官方预置的参考图id
  • └ mask_url
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg
  • 指定上身区域的maskurl
  • └ similar_strength
  • String
  • 可选
  • high
  • 生图与参考图的相似度,low:低;middle:中;high:高
  • └ prompt
  • String
  • 可选
  • 叶子,草地
  • 参考图高级配置,仅针对换模特换背景有效,仅针对部分开发者开放
  • └ auto_match_scene_figure_position
  • Boolean
  • 可选
  • false
  • 对应绘蛙界面的换模特换背景功能下,是否匹配模特位置,在相似度在high的时候生效
  • item_model
  • GenImageItemReq
  • 可选
  • 仅自由姿势时使用,商品模型的id,对应绘蛙界面的商品模型选择
  • └ item_model_id
  • String
  • 可选
  • 1
  • 商品模型id
  • └ auto_hand_refine
  • Boolean
  • 可选
  • false
  • 是否开启自动修手
  • item_image
  • AigcImageMattingImgDTO
  • 可选
  • 商品图片参数,图片能在5秒内被下载,固定姿势和平铺图使用,对应平铺图和固定姿势的商品图选择
  • └ original_image_url
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg
  • 本地上传的原始图片地址
  • └ mask_image_url
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg
  • 抠图后商品蒙版图片地址
  • └ person_mask_image_url
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg
  • 抠图后人物蒙版图片地址
  • composite_images
  • InputImageMattingDTO []
  • 可选
  • [ { "original_image_url": "https://img.alicdn.com/imgextra/i4/2217286866533/O1CN011y8ATYTowl6rdsE_!!2217286866533-0-aigc_business_user.jpg", "mask_image_url": "https://img.alicdn.com/imgextra/i4/2217286866533/O1CN011y8ATaBykBbugv4_!!2217286866533-2-aigc_business_user.png", "image_type": 1 }, { "original_image_url": "https://img.alicdn.com/imgextra/i2/2217286866533/O1CN011y8ATYTowlt8zKW_!!2217286866533-0-aigc_business_user.jpg", "mask_image_url": "https://img.alicdn.com/imgextra/i1/2217286866533/O1CN011y8ATXgVVeafvOI_!!2217286866533-2-aigc_business_user.png", "image_type": 2 } ]
  • 数组形式的商品图,用于替换item_image中的original_image_url字段。推荐使用该字段。多个item_image组成,其中original_image_url和composite_images二选一,请注意都传认original_image_url,,平铺图的上下装等组合使用的参数
  • └ image_type
  • Number
  • 可选
  • 1
  • 类型,1表示上装,2表示下装,3表示连衣裙,7表示包包包上身,使用界面上鞋子上脚的单视角图,则使用6,多视角时,4表示鞋子上脚内侧,5表示鞋子上脚外侧
  • └ original_image_url
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i4/2217286866533/O1CN011y8ATYTowl6rdsE_!!2217286866533-0-aigc_business_user.jpg
  • 商品图片经过绘蛙界面处理后的生图原图
  • └ mask_image_url
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i4/2217286866533/O1CN011y8ATaBykBbugv4_!!2217286866533-2-aigc_business_user.png
  • mask图,选中区域是黑色的黑白图
  • └ user_upload_image_url
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i4/2217286866533/O1CN011y8ATYTowl6rdsE_!!2217286866533-0-aigc_business_user.jpg
  • 用户通过绘蛙界面上传的原图,用于原分辨率生成使用
  • user_model_group
  • GenImageUserModelGroupReq
  • 可选
  • 模特模型参数,对应绘蛙界面的任务模型的选择
  • user_models
  • GenImageUserModelReq []
  • 可选
  • {}
  • 模特模型
  • └ user_model_id
  • String
  • 可选
  • 1
  • 模特模型id
  • └ generate_by_original_dpi
  • Boolean
  • 可选
  • false
  • 商品图的高大于2K时,可以使用原分辨率生成的功能
  • bag_related_info
  • BagRelatedInfoReq
  • 可选
  • 包包上身的参数,选择包包上身必须传递
  • └ bag_size
  • String
  • 可选
  • 中号
  • 包包上身对应的包包尺寸,可选:小号、中号、大号
  • └ bag_type
  • String
  • 可选
  • 腋下包
  • 包包类型,对应界面的包包类型,可选有:腋下包、手拎包、腰包、背包、斜挎包
  • └ mannequin_type
  • String
  • 可选
  • 1
  • 固定姿势下使用,1表示换模特换背景, 2表示换模特, 3 表示换背景
  • └ task_biz_type
  • Number
  • 必须
  • 1
  • 生图任务类型,目前1对应绘蛙界面的换模特换背景;10对应绘蛙界面的平铺图,11对应绘蛙界面的鞋子上脚,12对应绘蛙界面的包包上身

响应参数

名称 类型 示例值 描述
succeed Boolean true 是否成功
error_codes ErrorCodeDTO [] errorCodes
  • └ code
  • String
  • error
  • 错误码
  • └ message
  • String
  • error
  • 错误描述
model GenImageSubmitResult [] model
  • └ task_id
  • Number
  • 12
  • 任务id
  • └ pass_through
  • String
  • {}
  • 透传参数
  • └ error_msg
  • String
  • error
  • 错误信息
  • └ error_code
  • String
  • error
  • 错误码
error ErrorCodeDTO 错误信息
  • └ code
  • String
  • error
  • 错误码
  • └ message
  • String
  • message
  • 错误描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LianfanHuiwaTaskImageSubmitRequest req = new LianfanHuiwaTaskImageSubmitRequest();
LianfanHuiwaTaskImageSubmitRequest.BatchGenImgTopReq obj1 = new LianfanHuiwaTaskImageSubmitRequest.BatchGenImgTopReq();
LianfanHuiwaTaskImageSubmitRequest.BatchGenImageRequest obj2 = new LianfanHuiwaTaskImageSubmitRequest.BatchGenImageRequest();
List<LianfanHuiwaTaskImageSubmitRequest.GenImageRequest> list4 = new ArrayList<LianfanHuiwaTaskImageSubmitRequest.GenImageRequest>();
LianfanHuiwaTaskImageSubmitRequest.GenImageRequest obj5 = new LianfanHuiwaTaskImageSubmitRequest.GenImageRequest();
list4.add(obj5);
obj5.setPassThrough("{}");
LianfanHuiwaTaskImageSubmitRequest.GenImageSceneGroupReq obj7 = new LianfanHuiwaTaskImageSubmitRequest.GenImageSceneGroupReq();
obj7.setImageCount(1L);
List<LianfanHuiwaTaskImageSubmitRequest.GenImageSceneReq> list9 = new ArrayList<LianfanHuiwaTaskImageSubmitRequest.GenImageSceneReq>();
LianfanHuiwaTaskImageSubmitRequest.GenImageSceneReq obj10 = new LianfanHuiwaTaskImageSubmitRequest.GenImageSceneReq();
list9.add(obj10);
obj10.setSceneId("1");
obj10.setMaskUrl("https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg");
obj7.setScenes(list9);
obj7.setSimilarStrength("high");
obj7.setPrompt("叶子,草地");
obj7.setAutoMatchSceneFigurePosition(false);
list6.setSceneGroup(obj7);
LianfanHuiwaTaskImageSubmitRequest.GenImageItemReq obj12 = new LianfanHuiwaTaskImageSubmitRequest.GenImageItemReq();
obj12.setItemModelId("1");
list11.setItemModel(obj12);
obj5.setAutoHandRefine(false);
LianfanHuiwaTaskImageSubmitRequest.AigcImageMattingImgDTO obj14 = new LianfanHuiwaTaskImageSubmitRequest.AigcImageMattingImgDTO();
obj14.setOriginalImageUrl("https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg");
obj14.setMaskImageUrl("https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg");
obj14.setPersonMaskImageUrl("https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg");
List<LianfanHuiwaTaskImageSubmitRequest.InputImageMattingDTO> list16 = new ArrayList<LianfanHuiwaTaskImageSubmitRequest.InputImageMattingDTO>();
LianfanHuiwaTaskImageSubmitRequest.InputImageMattingDTO obj17 = new LianfanHuiwaTaskImageSubmitRequest.InputImageMattingDTO();
list16.add(obj17);
obj17.setImageType(1L);
obj17.setOriginalImageUrl("https://img.alicdn.com/imgextra/i4/2217286866533/O1CN011y8ATYTowl6rdsE_!!2217286866533-0-aigc_business_user.jpg");
obj17.setMaskImageUrl("https://img.alicdn.com/imgextra/i4/2217286866533/O1CN011y8ATaBykBbugv4_!!2217286866533-2-aigc_business_user.png");
obj17.setUserUploadImageUrl("https://img.alicdn.com/imgextra/i4/2217286866533/O1CN011y8ATYTowl6rdsE_!!2217286866533-0-aigc_business_user.jpg");
obj14.setCompositeImages(list16);
list13.setItemImage(obj14);
LianfanHuiwaTaskImageSubmitRequest.GenImageUserModelGroupReq obj19 = new LianfanHuiwaTaskImageSubmitRequest.GenImageUserModelGroupReq();
List<LianfanHuiwaTaskImageSubmitRequest.GenImageUserModelReq> list21 = new ArrayList<LianfanHuiwaTaskImageSubmitRequest.GenImageUserModelReq>();
LianfanHuiwaTaskImageSubmitRequest.GenImageUserModelReq obj22 = new LianfanHuiwaTaskImageSubmitRequest.GenImageUserModelReq();
list21.add(obj22);
obj22.setUserModelId("1");
obj19.setUserModels(list21);
list18.setUserModelGroup(obj19);
obj5.setGenerateByOriginalDpi(false);
LianfanHuiwaTaskImageSubmitRequest.BagRelatedInfoReq obj24 = new LianfanHuiwaTaskImageSubmitRequest.BagRelatedInfoReq();
obj24.setBagSize("中号");
obj24.setBagType("腋下包");
list23.setBagRelatedInfo(obj24);
obj5.setMannequinType("1");
obj2.setGenImageRequests(list4);
obj2.setTaskBizType(1L);
obj1.setBatchGenImageRequest(obj2);
req.setBatchGenImgTopReq(obj1);
LianfanHuiwaTaskImageSubmitResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<lianfan_huiwa_task_image_submit_response>
    <succeed>true</succeed>
    <error_codes>
        <error_code_d_t_o>
            <code>error</code>
            <message>error</message>
        </error_code_d_t_o>
    </error_codes>
    <model>
        <gen_image_submit_result>
            <task_id>12</task_id>
            <pass_through>{}</pass_through>
            <error_msg>error</error_msg>
            <error_code>error</error_code>
        </gen_image_submit_result>
    </model>
    <error>
        <code>error</code>
        <message>message</message>
    </error>
</lianfan_huiwa_task_image_submit_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部