AI 助理
文档备案控制台
官方文档
首页 电商经营助手 开发参考 素材优化 虚拟试穿

虚拟试穿

更新时间：
复制 MD 格式
产品详情
我的收藏

1、产品概述

虚拟试穿是一款基于AI算法的图像生成类API服务，能够依据用户输入的服装图和模特图，将服装替换模特现有服装，保有模特的其他细节和画面细节，不改变模特动作、面容等，且实现服装上身的合理性和适配性。用户只需传入原始商品图URL，即可获得处理后的干净图片。

2、适用场景

  • 服装鞋帽类虚拟试穿：

支持上装、外套、下装、连衣裙、连体衣、袜子、鞋子、帽子、耳饰、项链、手链、围巾、包包、眼镜共计14种服装鞋帽品类的虚拟试穿，用户上传人物图片和商品图片后，可根据人物姿态及身体部位智能匹配商品位置与比例，即可生成自然、真实的试穿效果，直观展示服装上身表现，呈现协调、逼真的穿戴效果；

  • 换模特（模特换肤／换脸）

用户提供原模特场景图和目标模特的人脸或模特参考图，将目标人物的面容应用到原图模特上。适用于客户指定模特、品牌形象统一及不同市场的人物形象适配，也可减少与其他商家使用相同模特形象的重复。

  • 换姿势（姿势裂变）

用户提供原模特场景图和指定 pose 的姿势参考图，生成原有人物及穿搭在新姿势下的效果，展示商品在站立、抬手、转身等不同姿态下的版型、轮廓与上身表现。

  • 电商商品展示与营销：

帮助商家快速生成不同商品的模特试穿图片，减少传统拍摄、换装及后期制作成本，提高商品图片的生产效率；

  • 在线购物体验优化：

消费者可通过虚拟试穿预览商品穿戴效果，更直观地了解商品的款式、搭配及整体效果，辅助购买决策并提升购物体验；

3、功能介绍

功能

支持范围

用户输入与指定方式

场景价值

换服装／商品穿戴

  • 服装：上装、下装（裤装、半身裙）、外套、连衣裙、连体衣／连体裤。

  • 鞋帽：鞋子、袜子、帽子。

  • 配饰：耳饰、项链、手链、围巾、包、眼镜。

上传模特图与商品图，商品即可自然上身——系统会根据服装品类自动匹配穿戴位置，让姿态、比例和穿着层次都与真人效果一致，且保持原图的人物场景与姿态

试穿模式：

  • 支持单件试穿

  • 支持多件穿搭（一张多件和多张图多件）

注：11月新上多件穿搭能力

统一生成服装、鞋帽及配饰的穿戴效果，减少逐件换装与实拍工作。

换模特／模特换肤（换脸）

支持用户指定目标模特；

原图可为单件试穿图或多件穿搭图。

上传原始模特场景图，再提供 1 张目标人物的人脸照或清晰的模特参考图，即可把目标人物的面容与身份特征替换到场景中的模特身上

原有穿搭、姿势和场景全部保留，生成结果沿用场景图中的人物姿态与背景。

使用客户指定或已获授权的模特形象，减少与现有模特形象重复，统一品牌视觉。

换姿势／姿势裂变

按用户提供的指定 pose 生成；

原图可为单件试穿图或多件穿搭图。

上传原模特场景图和 1 张姿势参考图，即可让模特换上参考图中的动作——人物与穿搭保持不变，衣物的褶皱、垂坠和层次会随新姿势自然调整；

展示商品在不同姿势下的版型、轮廓与上身样式，扩充详情页和营销素材。

4、效果示意

场景

类型／搭配说明

原模特场景图

商品图／参考图

效果图

单件试穿

马甲

黑色盘扣无袖马甲

image.png

image.png

image.png

单件试穿

上装

image.png

image.png

image.png

单件试穿

下装

image.png

image.png

image.png

单件试穿

鞋子

image.png

image.png

image.png

单件试穿

连体衣

image.png

image.png

image.png

单件试穿

裙子

image.png

image.png

image.png

单件试穿

帽子

image.png

image.png

image.png

多件试穿

两件搭配

连衣裙＋高跟鞋

image.png

image.png

image.png

多件试穿

三件搭配

条纹 Polo 衫＋牛仔短裤＋工装靴

image.png

image.png

image.png

多件试穿

四件搭配

印花 T 恤＋裤子＋帽子＋包

image.png

image.png

image.png

换模特

模特换肤／换脸

保留原有上衣、裤装与场景

image.png

image.png

image.png

换姿势

指定 pose

保留原有穿搭，调整为参考图中的抬手姿态

image.png

image.png

image.png

5、开发指南

线上提供两类 API：同步 API 和异步 API。同步 API 支持单件试穿、多件试穿、换模特和换姿势，包括已有多件穿搭场景下的换模特、换姿势；异步 API 仅支持单件试穿。

能力／调用方式

同步 API

异步 API

单件试穿

✓

✓

多件试穿

✓

—

换模特（原图可为单件或多件穿搭）

✓

—

换姿势（原图可为单件或多件穿搭）

✓

—

返回方式

当次请求直接返回生成结果

提交后返回 TaskId，再查询结果

输出分辨率

当前为 1K

支持 1K、2K

请求参数

参数名称

类型

必填

参数描述

示例值

ModelImageUrl

String

是

  • 模特场景图 URL，仅支持传入 1 张。

  • 图片须可通过 http/https 公网访问

  • 支持 JPG、JPEG、PNG、BMP、WEBP 格式

  • 宽和高均在 256–2049 像素之间

  • 单张文件大小不超过 10MB。

https://example.com/model.jpg\

TryonType

String

否

此参数只在试穿场景生效，定义试穿的商品数量。默认值singletryon

取值：

• singletryon：单件上身

• multitryon：多件搭配

singletryon

ClothImageUrl

Array<String>

条件必填

商品图 URL 列表。单件上身与多件搭配场景下必填。

• 单件上身：传入同一商品的不同视角图，标准版仅支持最多2 张商品图，但要求所有图有且仅有 1 件主体商品，建议使用商品白底图。

• 多件搭配：传入所有要上身的商品图，标准版仅支持 最多2 张商品图（每张图内可含多件商品）。单次搭配最多 6 件服装及配饰。

注意，换衣、换脸、换姿势三种模式，每次调用请仅填写其中一个，不可同时上传。

["https://example.com/top.jpg","https://example.com/bag.jpg"]

ClothType

Array<String>

否

指定本次需要试穿的商品类型，支持一次传入多个；不传时自动识别商品图中支持范围内的全部品类。

可选值：tops 上衣、outwear 外套、bottoms 下装、dresses 连衣裙、tops and bottoms 连体衣、socks 袜子、shoes 鞋、hats 帽子、earrings 耳饰、necklaces 项链、braceles 手链、scarves 围巾、bags 包包、glasses 眼镜

["tops","bottoms","glasses"]

Mode

String

是

试穿模式，用于确定商品图数量与搭配件数的上限。目前只支持“标准”

标准

ModelTemplateUrl

String

条件必填

模特模板图 URL，仅支持传入 1 张，用于提供人物的性别、肤色、年龄、体型等身份信息参考。

模特换肤场景下必填；更换服装、更换姿势场景下请勿传入该参数。换衣、换脸、换姿势三种模式，每次调用请仅填写其中一个，不可同时上传。

建议使用官方提供的模特模板。体验地址：电商经营助手 Aidge 控制台

https://example.com/model\_template.jpg\

PoseTemplateUrl

String

条件必填

姿势模板图 URL，仅支持传入 1 张，用于提供人物姿势参考。

姿势裂变场景下必填。

传入后按模板姿势生成；

未传入时，若已提供模特场景图则沿用场景中的姿势，否则保留模特来源图的姿势。

注意，换衣、换脸、换姿势三种模式，每次调用请仅填写其中一个，不可同时上传。

建议使用官方提供的姿势模板。体验地址：电商经营助手 Aidge 控制台

https://example.com/pose\_template.jpg\

Ratio

String

否

输出图片的宽高比，默认与 ModelImageUrl 原图保持一致；可指定 1:1、2:3、3:4、9:16。

1:1

Resolution

String

否

输出图片分辨率。

同步接口：支持 1K

异步接口：支持 1K、2K（异步接口仅支持单件搭配场景）

1K

请求示例

{
  "TryonType": "multitryon",
  "ModelImageUrl": "https://img.alicdn.com/imgextra/i3/O1CN019PkZE24uLA_!!60007171-2-tps-1024-1536.png",
  "ModelTemplateUrl": "https://oss-pai-jg4hxfqt30eukcqco3-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/eval/tryon400-20261027/model_templas/01.png",
  "Mode": "标准",
  "Resolution": "1K",
  "ClothType": "dresses,necklaces,bags"
}

响应参数

参数名

类型

描述

Code

String

状态码，如"success"

Success

Boolean

是否成功：true代表成功，false代表失败

Message

String

RequestId

String

请求ID：用来识别唯一一次请求调用

Data

Object

返回的结果结构体信息

Data.Status

String

任务状态，如"COMPLETED"

Data.Result

Object

任务执行结果

Data.Result.ImageUrl

Object

单张图片的识别结果

Data.Result.ImageWidth

Number

生成图片的真实宽度

Data.Result.ImageHeight

Number

生成图片的真实高度

Data.UsageMap

Object

用量字段

Data.UsageMap.ProcessedImageCount

Number

已处理图片数量

Data.UsageMap.Resolution

String

图片分辨率

响应示例

{
  "Data": {
    "ImageUrl": "https://dashscope-a717.oss-accelerate.aliyuncs.com/1d/7a/20261109/2f0f/06ca433e-c997-9332-bfe1-2153b49dbca6_qwen_image3_serving_output_0.png?Expires=17942978&OSSAccessKeyId=&Signature=J2iuXQNt5dA0PR%2F%2FSTJyo3fEK58%3D",
    "UsageMap": {
      "ProcessedImageCount": 1,
      "Resolution": "1K"
    },
    "ImageHeight": "1536",
    "ImageWidth": "1024"
  },
  "RequestId": "01A1BF31-6E39-12DD-AF4D-E77941E0555C",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

6、错误码

参考：错误码

7、计费方式

  • 1K分辨率：¥0.4 元/张（同步+异步）

  • 2K分辨率：¥0.5 元/张（仅异步）

8、使用限制

  • 调用模式：仅支持异步调用，默认 QPS = 5，单次同步请求超时上限 30 秒。

  • 输入图片：JPG / JPEG / PNG / BMP / WEBP。

  • 计费：按 ProcessedImageCount 和Resolution计件

上一篇：智能出图下一篇：文案优化（废弃）