在时尚电商的数字化转型中，AI 虚拟试衣（AI Clothes Try-On） 正在解决“非标准化穿着效果”的痛点。区别于简单的贴图滤镜，玩美移动（Perfect Corp.）的 API 方案，允许品牌通过高精度的人体分析与图像生成算法，实现物理级真实的服装模拟。
本文将基于最新的 YCE AI Clothes API (v2.0) 文档，为您拆解实现虚拟试衣的完整技术步骤。
一、 技术架构：基于server端运算的异步处理
不同于即时响应的简单接口，高质量的 AI 试衣涉及复杂的算力调度。其核心流程分为：文件预上传、任务创建、状态轮询、结果获取。这种架构能够支撑高分辨率图像的处理，并确保在并发高峰下的系统稳定性。
二、 核心集成步骤与代码实现
1. 文件预传输：利用 File API 上传人像
首先，通过 File API 申请上传通道。建议使用高分辨率的全身照片，并确保背景简洁。
curl --request POST \ --url https://yce-api-01.makeupar.com/s2s/v2.0/file/cloth \ --header 'Authorization: Bearer YOUR_API_KEY' \ --header 'content-type: application/json' \ --data '{ "files": [ { "content_type": "image/jpg", "file_name": "full_body_photo_01_3dbd1b6683.jpg", "file_size": 547541 } ] }'
2. 获取上传凭证与实际传输
服务器将返回一个 file_id 和一个具有时效性的 S3 预签名 URL。开发者需使用 PUT 方法将二进制文件直接传输至该地址。
Sample Response (提取 URL):
{ "status": 200, "data": { "files": [ { "content_type": "image/jpg", "file_name": "full_body_photo_01_3dbd1b6683.jpg", "file_id": "SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9/13W5TOD8/u/FfjK3xgCQ+hRt9MJXBFaud", "requests": [ { "method": "PUT", "url": "https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature...", "headers": { "Content-Length": "547541", "Content-Type": "image/jpg" } } ] } ] }}
执行物理上传:
curl --location --request PUT 'https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature...' \ --header 'Content-Type: image/jpg' \ --header 'Content-Length: 547541' \ --data-binary @'./full_body_photo_01_3dbd1b6683.jpg'
3. 创建 AI 试衣任务
准备好用户图（src）和衣服参考图（ref）后，通过 AI Task API 提交任务。您可以指定服装类别（如 full_body）。
Example Request:
curl --request POST \ --url https://yce-api-01.makeupar.com/s2s/v2.0/task/cloth \ --header 'Authorization: Bearer YOUR_API_KEY' \ --header 'content-type: application/json' \ --data '{ "src_file_url": "https://plugins-media.makeupar.com/strapi/assets/clothes_03_cccd5d4803.jpeg", "ref_file_url": "https://plugins-media.makeupar.com/strapi/assets/clothes_reference_full_body_01_5a000d999f.png", "garment_category": "full_body" }'
4. 任务轮询与结果提取
由于 AI 运算需要时间，系统会返回一个 task_id。开发者需定时轮询该 ID 直至状态变为 success。
轮询请求:
curl --request GET \ --url https://yce-api-01.makeupar.com/s2s/v2.0/task/cloth/<YOUR_TASK_ID> \ --header 'Authorization: Bearer YOUR_API_KEY' \ --header 'content-type: application/json'
成功返回结果:
{ "status": 200, "data": { "error": null, "results": { "url": "https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature..." }, "task_status": "success" }}
三、 技术亮点：为什么选择 S2S API 方案？
1. 极高自由度：不仅支持平铺产品图（Product Image），还支持直接从模特图中提取服装进行“整套复刻”。
2. 安全性：通过后端 API 调用（YOUR_API_KEY 隐藏在服务端），有效防止了前端 Key 泄露风险。
3. 支持大规模批处理：异步任务机制允许品牌同时为成千上万的用户生成个性化试衣效果图，适合大规模营销活动。
四、 错误处理与调试提示
在集成过程中，请务必处理可能的异常响应，例如：
l 401 Unauthorized: 检查 API Key 是否有效或是否包含 Bearer 前缀。
l InvalidAccessToken: 确保当前环境权限已开通 AI Clothes 模块。
结语
玩美移动的 AI Clothes API 将复杂的计算机视觉与图形学算法封装进了一套标准的任务调度系统中。对于开发者而言，只需掌握这套 File + Task 的调用逻辑，即可在任何设备、任何平台上构建出沉浸式的虚拟试衣空间。
立即查阅完整文档: YouCam API
