注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 天猫家装API

taobao.ihome.aigc.qiaoyi.item.scene.generate (家装aigc商品图生场景图)

家装aigc商品图生场景图

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_to_scene_req ItemToSceneReq 必须 请求
  • └ image_url
  • String
  • 必须
  • https://img.alicdn.com/imgextra/i4/6000000000386/O1CN015w0Bww1Eipk0SE1k8_!!6000000000386-2-ihome.png
  • 输入的图片,需要透明图
  • └ need_merge
  • Boolean
  • 可选
  • false
  • 是否需要合图,默认false
  • └ style
  • String
  • 必须
  • 原木
  • 风格,详见说明
  • position
  • FixedPosition
  • 必须
  • 商品图在场景图中的位置,需要归一化到0-1之间
  • └ top
  • String
  • 必须
  • 0.20946745562130178
  • top
  • └ left
  • String
  • 必须
  • 0.26272189349112424
  • left
  • └ bottom
  • String
  • 必须
  • 0.6319526627218935
  • bottom
  • └ right
  • String
  • 必须
  • 0.9124260355029585
  • right
  • └ image_cnt
  • Number
  • 必须
  • 4
  • 期望产出的图片数量,越多越慢,建议4
  • └ flip
  • Boolean
  • 可选
  • false
  • 是否需要翻转图片,默认false
  • └ room_type
  • String
  • 必须
  • 卧室
  • 房间类型,详见说明
  • └ object_type
  • String
  • 必须
  • 商品对象类型,详见说明
  • └ outer_user_id
  • Number
  • 可选
  • 123
  • 外部用户id
  • └ user_prompt
  • String
  • 可选
  • 法式风格客厅
  • 用户输入的提示词
  • └ model_type
  • String
  • 可选
  • INDOOR
  • 室内INDOOR 室外OUTDOOR
  • └ image_ratio
  • String
  • 可选
  • 1_1
  • 高宽比,生成图比例,1_1,3_4,4_3可选

响应参数

名称 类型 示例值 描述
data Data 结果
  • └ queue_pos
  • Number
  • 0
  • 当前队列长度
  • └ predict_generate_time_range
  • Number []
  • 预计更新时间区间
  • └ task_id
  • Number
  • 64602
  • 任务id
  • └ shard_id
  • Number
  • 55566
  • 分片id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
IhomeAigcQiaoyiItemSceneGenerateRequest req = new IhomeAigcQiaoyiItemSceneGenerateRequest();
IhomeAigcQiaoyiItemSceneGenerateRequest.ItemToSceneReq obj1 = new IhomeAigcQiaoyiItemSceneGenerateRequest.ItemToSceneReq();
obj1.setImageUrl("https://img.alicdn.com/imgextra/i4/6000000000386/O1CN015w0Bww1Eipk0SE1k8_!!6000000000386-2-ihome.png");
obj1.setNeedMerge(false);
obj1.setStyle("原木");
IhomeAigcQiaoyiItemSceneGenerateRequest.FixedPosition obj2 = new IhomeAigcQiaoyiItemSceneGenerateRequest.FixedPosition();
obj2.setTop("0.20946745562130178");
obj2.setLeft("0.26272189349112424");
obj2.setBottom("0.6319526627218935");
obj2.setRight("0.9124260355029585");
obj1.setPosition(obj2);
obj1.setImageCnt(4L);
obj1.setFlip(false);
obj1.setRoomType("卧室");
obj1.setObjectType("床");
obj1.setOuterUserId(123L);
obj1.setUserPrompt("法式风格客厅");
obj1.setModelType("INDOOR");
obj1.setImageRatio("1_1");
req.setItemToSceneReq(obj1);
IhomeAigcQiaoyiItemSceneGenerateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<ihome_aigc_qiaoyi_item_scene_generate_response>
    <data>
        <queue_pos>0</queue_pos>
        <task_id>64602</task_id>
        <shard_id>55566</shard_id>
    </data>
</ihome_aigc_qiaoyi_item_scene_generate_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

返回
顶部