一、技术优势
·自研模型，精准还原：基于 MPS 自研换装模型，服装材质与纹理高度还原，视觉效果更真实。换装效果不受参考模特图原有服饰的颜色与版型影响，目标服装色彩与廓形准确呈现。
·多场景支持：覆盖全品类服装展示需求，普通衣物和内衣（含情趣内衣）均可支持；支持附加提示词微调输出效果，满足精细化运营场景。
二、前提条件
在使用本功能前，你需完成以下前置操作：
·腾讯云账号注册/登录、开通 MPS 产品、完成服务角色授权。
·若你使用腾讯云子账号，还需要保证账号有足够权限使用 MPS 产品。
具体指引请参考 快速入门。账号授权问题可参考 账号授权 文档。
三、计费说明
参考 计费说明文档。
四、创建 AI 换装任务
调用 ProcessImage 接口，发起 AI 换装任务，具体参数配置说明如下：
·通过 InputInfo 传入参考模特图，限定1张。
·通过 AiTryOnConfig 配置换装模型、分辨率、额外换装要求几个参数。参数介绍见下表。
| 字段 | 说明 |
| Model | 换装模型，可选值及说明如下：tryon-1.0-lite：轻量档，速度优先。tryon-1.0-flash：均衡档，兼顾效果与时延。tryon-1.0-pro：高质量档，效果优先。 |
| Prompt | 换装指令。 |
| Resolution | 输出图片分辨率，可选值：1K/2K/4K。 |
·通过 AddOnParameter.ImageSet 传入参考图，数量上限为 13 张。建议按需传入，避免非必要参考图影响生成效果。参数介绍见下表。
| 字段 | 说明 |
| Type | 参考图类型值，可选值及说明如下：garment：服装参考图。background：背景参考图。identity：身份参考图。pose：姿势参考图。accessories：配饰参考图。shoes：鞋类参考图。 |
| Image | 传入参考图片。 |
发起示例如下：
{ "InputInfo": { "Type": "URL", "UrlInputInfo": { "Url": "https://test-1234567.cos.ap-guangzhou.myqcloud.com/photo/model.png"//请替换为你的参考模特图 } }, "OutputStorage": { "Type": "RMS" // 输出结果，结果返回一个小时有效的链接 }, "OutputDir": "/share/output/", "ImageTask":{ "AiTryOnConfig":{ "Model": "tryon-1.0-flash",//换装模型，可选值：tryon-1.0-lite; tryon-1.0-flash; tryon-1.0-pro "Resolution": "2K",//输出图片分辨率 "Prompt": "将[图片1]中模特的服装替换为[图片2]中的服装，将[图片1]的背景替换为[图片3]中的场景"// （选填）换装指令 } }, "AddOnParameter": { "ImageSet": [ { "Type": "garment", // 选填，默认为garment，可选garment/background/identity/pose/accessories/shoes "Image": { "Type": "URL", "UrlInputInfo": { "Url": "https://test-1234567.cos.ap-guangzhou.myqcloud.com/photo/garment1.png" // 这里输入服饰参考图 } } }, { "Type": "background", // 选填，默认为garment，可选garment/background/identity/pose/accessories/shoes "Image": { "Type": "URL", "UrlInputInfo": { "Url": "https://test-1234567.cos.ap-guangzhou.myqcloud.com/photo/background1.png" // 这里输入背景参考图 } } } ] }}
也建议你通过 API Explorer 实现快速验证，选择“媒体处理”产品，在左侧接口列表选择 发起图片处理 接口。你可以将上述 JSON 复制到 API Explorer 的 JSON 模式中，切换至“表单”模式可以自动解析，调整输入输出路径等必要参数后，再单击发起调用即可。
五、查询任务结果
在使用 ProcessImage 发起图片处理任务后，会返回任务 ID（TaskId），例如：24000022-WorkflowTask-b20a8exxxxxxx1tt110253、24000022-ScheduleTask-774f101xxxxxxx1tt110253。调用 DescribeImageTaskDetail 接口，输入任务 ID 即可获取任务结果，你需要解析 ImageProcessTaskResultSet 字段获取任务结果。
响应成功示例：
{ "Response": { "RequestId": "req-yyy", "Status": "FINISH", "ErrMsg":<error message>, "ImageProcessTaskResultSet": [ { "Status": "FINISH", "Output": { "Path": "/aitryon/output/task-xxx/result.png", "SignedUrl": "https://example.com/result.png", "OutputStorage": { "Type": "COS", "CosOutputStorage": { "Region": "ap-guangzhou", "Bucket": "example-1250000000" } } } } ] }}
六、常见错误码
| ErrMsg | 含义 | 常见原因 |
| InvalidParameter | 参数不合法。 | 缺少 AiTryOnConfig、Model 非法、服饰图为空或超限。 |
| UnsupportedMediaType | 输入媒体类型不支持。 | 输入图片类型或来源不符合要求。 |
| ContentBlocked | 内容被安全策略拦截。 | 输入图片触发内容安全限制。 |
| InternalError | 执行失败。 | 生成服务异常。 |
| Failed | 服务内部错误。 | 内部处理异常。 |
| ServiceUnavailable | 服务暂不可用。 | 服务繁忙或依赖异常。 |
建议排查方式：
·参数类报错：优先检查字段是否齐全、枚举值是否合法。
·内容安全报错：优先检查模特图和服饰图内容。
·服务类报错：建议先重试，持续失败再联系服务侧排查。
七、（1）模特图
我们推荐上传「单人照」、「背景简单」的模特图，示例如下：
| ✅单人照 | ✅背景简单 |
我们不建议你上传「多人照」、「背景复杂」、「侧面角度」、「服饰类型冲突」（如模特图为连衣裙，换装服饰为单件上衣/下衣）的模特照，示例如下：
| ❌多人照 | ❌背景复杂 | ❌侧面角度 | ❌服饰类型冲突 |
八、（2）服饰图
我们推荐上传「背景简单」、「服装完整呈现」的服饰图，示例如下：
| ✅背景简单 | ✅服饰完整呈现 |
我们不建议你上传「多件服装交叠覆盖」、「背景复杂」、「服装细节模糊不清」、「人物姿势遮挡服装」的服饰照，示例如下：
| ❌多件服装交叠覆盖 | ❌背景复杂 | ❌服装细节模糊不清 | ❌人物姿势遮挡服装 |