媒体处理 AI 换装

功能简介
AI 换装功能基于模特图和服饰图，AI 自动完成试穿并生成换装效果图。无需真人拍摄、无需重复布景，一张模特图即可批量替换不同服饰款式。
﻿
技术优势
自研模型，精准还原：基于 MPS 自研换装模型，服装材质与纹理高度还原，视觉效果更真实。换装效果不受参考模特图原有服饰的颜色与版型影响，目标服装色彩与廓形准确呈现。
多场景支持：覆盖全品类服装展示需求，普通衣物和内衣（含情趣内衣）均可支持；支持附加提示词微调输出效果，满足精细化运营场景。
前提条件
在使用本功能前，您需完成以下前置操作：
腾讯云账号注册/登录、开通 MPS 产品、完成服务角色授权。
若您使用腾讯云子账号，还需要保证账号有足够权限使用 MPS 产品。
具体指引请参考 快速入门。账号授权问题可参考 账号授权 文档。
计费说明
参考 计费说明文档。
创建 AI 换装任务
调用 ProcessImage 接口，发起 AI 换装任务，具体参数配置说明如下：
通过 InputInfo 传入参考模特图，限定1张。
通过 AiTryOnConfig 配置换装模型、分辨率、额外换装要求几个参数。参数介绍见下表。
字段
说明
Model
换装模型，可选值及说明如下：
WAND-tryon-1.0-lite：轻量档，速度优先。
WAND-tryon-1.0-flash：均衡档，兼顾效果与时延。
WAND-tryon-1.0-pro：高质量档，效果优先。
Prompt
换装指令。
Resolution
输出图片分辨率，可选值：1K/2K/4K。
通过 AddOnParameter.ImageSet 传入服饰图，最多支持上传4张。
发起示例如下：
{
  "InputInfo": {
    "Type": "URL",
    "UrlInputInfo": {
      "Url": "https://test-1234567.cos.ap-guangzhou.myqcloud.com/photo/model.png"//请替换为您的参考模特图
    }
  },
  "OutputStorage": {//请替换为您的输出保存路径
    "Type": "COS",
    "CosOutputStorage": {
      "Bucket": "test-1234567",
      "Region": "ap-guangzhou"
    }
  },
  "ImageTask": {
    "AiTryOnConfig": {
      "Model": "WAND-tryon-1.0-pro",//换装模型，可选值：WAND-tryon-1.0-lite; WAND-tryon-1.0-flash; WAND-tryon-1.0-pro
      "Prompt": "将图二的上衣替换到图一的模特身上", // （选填）换装指令
      "Resolution": "1K"//输出图片分辨率
    }
  },
  "AddOnParameter": {
    "ImageSet": [
      {
        "Image": {
          "Type": "URL ",
          "UrlInputInfo": {
            "Url": "https://test-1234567.cos.ap-guangzhou.myqcloud.com/photo/garment-1.png"//请替换为服饰图，最多支持上传4张
          }
        }
      }
    ]
  }
}
也建议您通过 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
服务暂不可用。
服务繁忙或依赖异常。
建议排查方式：
参数类报错：优先检查字段是否齐全、枚举值是否合法。
内容安全报错：优先检查模特图和服饰图内容。
服务类报错：建议先重试，持续失败再联系服务侧排查。
如何选择模特图和服饰图，AI 换装效果更好？
（1）模特图
我们推荐上传「单人照」、「背景简单」的模特图，示例如下：
✅单人照
﻿
✅背景简单
﻿
我们不建议您上传「多人照」、「背景复杂」、「侧面角度」、「服饰类型冲突」（如模特图为连衣裙，换装服饰为单件上衣/下衣）的模特照，示例如下：
❌多人照
﻿
❌背景复杂
﻿
❌侧面角度
﻿
❌服饰类型冲突
﻿
（2）服饰图
我们推荐上传「背景简单」、「服装完整呈现」的服饰图，示例如下：
✅背景简单
﻿
✅服饰完整呈现
﻿
我们不建议您上传「多件服装交叠覆盖」、「背景复杂」、「服装细节模糊不清」、「人物姿势遮挡服装」的服饰照，示例如下：
❌多件服装交叠覆盖
﻿
❌背景复杂
﻿
❌服装细节模糊不清
﻿
❌人物姿势遮挡服装
﻿

字段	说明
Model	换装模型，可选值及说明如下： WAND-tryon-1.0-lite：轻量档，速度优先。 WAND-tryon-1.0-flash：均衡档，兼顾效果与时延。 WAND-tryon-1.0-pro：高质量档，效果优先。
Prompt	换装指令。
Resolution	输出图片分辨率，可选值：1K/2K/4K。

ErrMsg	含义	常见原因
InvalidParameter	参数不合法。	缺少 AiTryOnConfig、Model 非法、服饰图为空或超限。
UnsupportedMediaType	输入媒体类型不支持。	输入图片类型或来源不符合要求。
ContentBlocked	内容被安全策略拦截。	输入图片触发内容安全限制。
InternalError	执行失败。	生成服务异常。
Failed	服务内部错误。	内部处理异常。
ServiceUnavailable	服务暂不可用。	服务繁忙或依赖异常。

AI 换装

本页目录：

功能简介

技术优势

前提条件

计费说明

创建 AI 换装任务

查询任务结果

常见问题

常见错误码

如何选择模特图和服饰图，AI 换装效果更好？

（1）模特图

（2）服饰图