虚拟试穿（图像试穿）

试穿端点允许您使用图像参考将服装无缝地穿戴到人物身上。

模型名称： tryon

生命周期： stable

处理时间： ~15s–30s

输出格式： Auto (JPEG or PNG)

交付方式： URL (via Polling)

积分： 1 × sampleCount

请求

使用 JSON 有效负载将您的试穿配置提交到通用 /v1/run 端点。

POSThttps://fititon.app/api/v1/run

请求示例

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "garmentImage": "https://example.com/garment.jpg",
             "accuracy": "high",
             "sampleCount": 1
           }
         }'

响应

试穿生成在后台异步进行。您的请求将立即返回 200 OK 状态以及一个跟踪对象。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

轮询结果 您必须使用返回的 id 轮询状态端点（GET https://fititon.app/api/v1/status/{id}）以检索您生成的图像 URL。有关详细说明，请参阅 API 设置指南。

请求参数

必填参数

personImageRequiredstring

您想要穿戴服装的模型的基础图像。可以是公开可访问的 URL 或 Base64 编码的图像字符串。支持的格式：JPEG、PNG、WEBP。最大尺寸：25MB。

专业提示： 正面姿势且手臂可见的照片能产生最逼真的穿戴效果。拍摄前请移除遮盖身体的包、围巾或夹克。

格式要求 提交 Base64 字符串时，必须包含标准数据 URI 前缀（例如，data:image/jpeg;base64,...）。/v1/run 端点仅接受 JSON 有效负载，因此不支持 multipart/form-data 上传。

garmentImageRequiredstring

要试穿的服装图像。可以是公开可访问的 URL 或 Base64 编码的图像字符串。

专业提示： 白色背景的平铺服装照片效果明显优于挂在衣架上或皱巴巴的衣服。

可选参数

accuracy'standard' | 'high' | 'hyper'

定义试穿合身度的保真度。更高的准确性会增加生成精度，但可能需要稍长的时间。 默认值：standard

sampleCountinteger

每次请求生成的图像变体数量。必须介于 1 到 4 之间。额外的图像会消耗更多积分并线性增加处理时间。 默认值：1

运行时错误

此功能的运行时错误使用错误处理中记录的共享集。如果在处理过程中发生错误，status 将更新为 "error"，并且 error 字段将包含具体的失败原因。

积分成本

对于开发者 API 请求，虚拟试穿端点以每生成一张图像 1 积分 的固定费率运行，无论请求的 quality 等级如何。

公式： Cost = 1 × sampleCount

参数	每张图像的积分
固定费率	1