鞋靴模特API详情

鞋靴模特

鞋靴模特支持输入多视角鞋靴系列图片，同时对输入模特模板图的鞋子区域进行鞋靴AI试穿，实现模特鞋靴布局重绘生成，最终生成图片的效果, 布局自然、细节丰富、画面细腻、试穿结果逼真。可用于模特商品图设计、新鞋AI试穿、模特穿戴布局重绘等场景。

输入内容&效果示意：

错误输入示例：

应用场景

• 鞋靴商品设计：鞋靴商品设计领域，结合AI技术的优势，设计师们能够以前所未有的速度和精确度探索创新设计。设计师可以输入从复古皮革靴到未来感十足的运动鞋极速模特AI试穿，确保每一款新品都能商品图极速上架。

• 新鞋创意试穿：顾客在选购鞋靴时，难以全面体验心仪款式直接试穿。而新鞋创意试穿应用，顾客只需简单输入本人照片，就能“穿上”任何一款店铺新款鞋靴，直观感受外观搭配效果，大大提升了购物的便捷性和趣味性。

• 模特穿戴重绘：模特试穿能轻松更换模特展示的鞋靴款式，都能与模特的服装、背景完美融合，创造出多样化的时尚造型。这一过程无需重新拍摄，既节省成本又提高了效率。模特穿戴重绘都能帮助品牌快速响应市场变化。

特色优势

• 效果业界领先：鞋靴模特生成图像语义一致性更精准，AI局部创作布局自然、细节丰富、画面细腻、结果逼真，又保持视觉效果的和谐与专业性，无需担心人工合成的痕迹。

• 稳定、易用平台服务：提供在高并发、大流量下的稳定鞋靴模特图片生成响应，可直接调用的简单推理API 接口，服务简单易用，易被集成，兼容性强。

模型概览

输入限制

模特模板图：

• 图片分辨率：长宽比小于3：2，推荐为4：3。

• 图片格式：JPEG，PNG，JPG，BMP，WEB，AVIF。

• 图片大小：建议不超过5M。长宽比小于3：2，且长宽比推荐为4：3

• URL地址中不能包含中文字符。

鞋靴多视角图：

• 图片分辨率：长宽比小于3：2，推荐为4：3，长宽比尽量和templace_image_url一样；

• 图片格式：JPEG，PNG，JPG，BMP，WEB，AVIF。

• 图片大小：建议不超过5M。长宽比小于3：2，且长宽比推荐为4：3

• 图片个数：多视角图片个数小于3

• URL地址中不能包含中文字符。

HTTP调用接口

功能描述

本模型需要相对较长的算法调用时间，所以在接口层面采用了异步调用的方式进行任务提交，在通过任务接口提交作业之后，系统会返回对应的作业ID，随后可以通过对应的异步作业查询接口获取任务的状态并且在作业到达最终完成态后取回对应的作业结果。

前提条件

• 已开通服务并获得API-KEY：开通DashScope并创建API-KEY。

说明

接口限制：对单账户（含主账号与RAM子账号）任务下发接口限制QPS为2，并发任务数量限制为1。

作业提交接口调用

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/virtualmodel/generation/

入参描述

出参描述

请求示例

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/XXXXXXX/XXXXXX' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "XXXXXXX",
    "input": {
        "template_image_url": "http://xxx/1.jpg",
        "shoe_image_url": ["http://xxx/2.jpg"]
    },
    "parameters": 
    {
        "n": 1
    }
}'

响应示例

{
    "output": {
		"task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1", 
    	"task_status": "PENDING"
    }
    "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}

异常响应示例

在提交作业请求出错的情况下，输出的结果中会通过 code 和 message 指明出错原因。

{
    "code":"InvalidApiKey",
    "message":"Invalid API-key provided.",
    "request_id":"fb53c4ec-1c12-4fc4-a580-cdb7c3261fc1"
}

作业任务状态查询和结果获取接口

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

入参描述

出参描述

请求示例

以下示例展示通过CURL命令来调用本模型的脚本。

curl -X GET \
--header 'Authorization: Bearer <YOUR-DASHSCOPE-API-KEY>' \
https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-af6e-a0c6a421c010

响应示例（作业执行中）

作业提交后将处于排队状态，在得到调度之后将转为运行状态，此时作业的状态为RUNNING，task_metrics将给出具体batch状态。

{
    "request_id":"e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
    "output":{
        "task_id":"86ecf553-d340-4e21-af6e-a0c6a421c010",
        "task_status":"RUNNING",
        "task_metrics":{
            "TOTAL":1,
            "SUCCEEDED":1,
            "FAILED":0
        }
    }
}

响应示例（作业成功执行完毕）

如果作业执行完成并成功之后，再次查询作业状态，接口将在告知作业状态的同时，一并将作业的结果返回。对于本模型，作业在结束之后的状态会持续保留24小时以备客户随时查询，24小时之后，作业将从系统中清除，相关的结果也将一并清除；对应的，作业生成的结果为图像的URL地址，出于安全考虑，该URL的下载有效期也是24小时，需要用户在获取作业结果后根据需要及时使用或者转存。

{
    "request_id":"<your request id>",
    "output":{
        "task_id":"<your task id>",
        "task_status":"SUCCEEDED",
        "submit_time":"xxx",
        "scheduled_time":"xxx",
        "end_time":"xxx",
        "error_message":"Success",
        "start_time":"xxx",
        "model_index":0,
        "error_code":0,
        "result_url":"http://oss.aliyuncs.com/xxx/abc.jpg"
    },
    "usage":{
        "image_count":1
    }
}

响应示例（作业失败）

如果因为某种原因作业失败，则作业状态会设置为FAILED，并且通过code和message字段指明错误原因。

{
  "request_id": "<your request id>",
  "output": {
    "task_id": "<your task id>",
    "task_status": "FAILED",
    "submit_time": "xxx",
    "scheduled_time": "xxx",
    "end_time": "xxx",
    "code": "InvalidImageResolution",
    "message": "The input image resolution is too large or small"
  },
  "usage": {
    "image_num": 0
  }
}

非标准错误码