虚拟试穿 API

什么是虚拟试穿 API？

虚拟试穿 API 接收人物照片和服装照片，然后生成该人物穿上服装的效果图，无需实体试衣间、摄影或新的影棚拍摄。它回答的是穿着效果问题，而不是产品目录图片问题。

Muapi 通过 AI 换装提供这一能力。单一端点接收 model_image_url 和 garment_image_url，返回合成结果。你只需一个 API 密钥，使用统一的提交与轮询流程，并按生成次数付费。

虚拟试穿与产品摄影的区别

两者相关但用途不同。虚拟试穿会在现有人物图中替换服装，结果是特定人物或模特的合身与穿着效果预览。产品摄影则从头生成适合目录的产品图，通过提示词控制背景和光线，并不一定将产品放到固定人物身上。如果你需要让购物者看到衣服穿在自己身上的效果，请使用虚拟试穿；如果你需要生成干净的商品列表图或生活方式产品图，请使用产品摄影。 比较产品摄影 →

主要能力

如何获得更好的输入质量和姿势效果

• 使用清晰、正面的人物照片。 单一人物、充足光线以及中性或站立姿势，能为服装放置提供更干净的参考。
• 尽量分离服装。 背景杂物较少的平铺服装图或模特架服装图，比穿在其他人身上的照片更容易实现准确的纹理和形状迁移。
• 让服装类别与身体覆盖范围匹配。 上衣、连衣裙和外套通常比复杂的多层服装更容易迁移；批量处理前请用自己的目录进行测试。
• 预留迭代空间。 与所有生成式图像模型一样，每次运行的结果会有所不同。如果合身或纹理不理想，可以使用更干净的源图重新生成。

隐私与同意

虚拟试穿会生成照片中人物的相似形象。只能提交已同意以这种方式使用照片的人，例如你本人、签署授权的模特，或明确选择加入试穿功能的客户。未经许可不得使用他人照片，也不要将真实人物的形象生成到其未同意的服装或场景中。Muapi 不会代替调用方核实同意，相关责任由 API 调用方承担。

如何调用虚拟试穿 API

1. 准备两张图片。 通过 POST /api/v1/upload_file 上传人物照片和服装照片，也可以使用任何公开可访问的 URL。
2. 提交请求。 调用 POST /api/v1/ai-dress-change，并提供 model_image_url 和 garment_image_url。
3. 轮询任务完成。 持续检查 GET /api/v1/predictions/{request_id}/result，直到 status 为 completed，然后下载合成图。

curl -X POST https://api.muapi.ai/api/v1/ai-dress-change \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "model_image_url": "https://example.com/model-photo.jpg",
    "garment_image_url": "https://example.com/garment-photo.jpg"
  }'

import requests

response = requests.post(
    "https://api.muapi.ai/api/v1/ai-dress-change",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "model_image_url": "https://example.com/model-photo.jpg",
        "garment_image_url": "https://example.com/garment-photo.jpg",
    },
)
request_id = response.json()["request_id"]

result = requests.get(
    f"https://api.muapi.ai/api/v1/predictions/{request_id}/result",
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(result.json())

常见问题