FASHN Try-On v1.6 API

POST Base URL: https://api.hiapi.ai /v1/tasks

复制页面

图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称	fashn-tryon-v1.6
类型	图像试穿（图生图）
接口	POST /v1/tasks
价格	见 HiAPI 定价

FASHN Try-On v1.6：上传一张人物照片和一张服装图，生成自然贴合的试穿效果图，支持上装、下装和连体装，无需提示词。

生产建议

生产环境建议

• 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
• GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
• 产物 URL 有有效期，拿到结果后请及时转存到自己的存储。

适用场景

电商商品上身图

把平铺或挂拍的商品图快速变成模特上身效果，减少实拍投入。

model_imagegarment_imagecategory

服装内容与种草

用同一张人物照片试穿多件单品，批量产出穿搭预览。

model_imagegarment_imageseed

跨品类试穿

上装、下装和连体装分别建模，按商品类别选择对应类别。

categorygarment_photo_type

请求参数

</> 生成示例代码

model string 必填

固定填 fashn-tryon-v1.6。

示例 fashn-tryon-v1.6

input object 必填

业务参数对象。

model_image string 必填

人物照片的公网 URL（http/https）。建议正面、单人、身体主要部位清晰可见。

garment_image string 必填

服装图的公网 URL（http/https）。平铺、挂拍或模特穿着的商品图都可以。

category enum 可选

服装类别。自动会从服装图识别；明确指定可以避免识别偏差。

默认 auto 可选值: topsbottomsone-piecesauto

mode enum 可选

生成模式。performance 更快，balanced 在速度和质量之间平衡，quality 更慢但细节更好。

默认 balanced 可选值: performancebalancedquality

garment_photo_type enum 可选

服装图类型。模特穿着选 model，平铺或挂拍选 flat-lay，自动会尝试识别。

默认 auto 可选值: automodelflat-lay

moderation_level enum 可选

服装图内容审核强度。permissive 只拦截明确暴露内容；conservative 还会拦截内衣和泳装。

默认 permissive 可选值: nonepermissiveconservative

seed integer 可选

随机种子。相同种子和输入会得到相同结果，换一个种子可以得到不同版本。

segmentation_free boolean 可选

开启后跳过人体解析，适合复杂姿势、遮挡或非标准人体比例的照片。

默认 true 示例 false

output_format enum 可选

输出图片格式。PNG 质量最高，JPEG 速度更快。

默认 png 可选值: pngjpeg

callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback

when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

上装试穿

把平铺的灯芯绒外套穿到人物照片上，保持人物姿态和面部不变，输出 972 × 1296。

请求体⧉

{
  "model": "fashn-tryon-v1.6",
  "input": {
    "model_image": "https://dev-static.hiapi.ai/model-onboarding/fashn-tryon-v1.6/2026/10/19/1792426518394-764c4dd31c38a98f-fashn-person.webp",
    "garment_image": "https://dev-static.hiapi.ai/model-onboarding/fashn-tryon-v1.6/2026/10/19/1792426519642-61b39dc0f55655a0-fashn-garment.jpg",
    "category": "tops",
    "mode": "balanced",
    "garment_photo_type": "auto",
    "moderation_level": "permissive",
    "segmentation_free": true,
    "output_format": "png"
  }
}

连体装试穿

用模特穿着的婚纱作为服装图，quality 模式 + JPEG 输出，实测 972 × 1296。

请求体⧉

{
  "model": "fashn-tryon-v1.6",
  "input": {
    "model_image": "https://dev-static.hiapi.ai/model-onboarding/fashn-tryon-v1.6/2026/10/19/1792426518394-764c4dd31c38a98f-fashn-person.webp",
    "garment_image": "https://dev-static.hiapi.ai/model-showcases/fashn-tryon-v1.6/2026/10/20/1792476966558-ca2f7b295dc5c30b-fashn-input-dress-hiapi.jpg",
    "category": "one-pieces",
    "mode": "quality",
    "garment_photo_type": "model",
    "moderation_level": "permissive",
    "segmentation_free": true,
    "output_format": "jpeg"
  }
}

下装试穿

换用 2:3 人物图试穿高腰长裤，输出与人物图一致，为 768 × 1152。

请求体⧉

{
  "model": "fashn-tryon-v1.6",
  "input": {
    "model_image": "https://dev-static.hiapi.ai/model-showcases/fashn-tryon-v1.6/2026/10/20/1792476965429-37164b74b97733c1-fashn-input-person-2x3-hiapi.jpg",
    "garment_image": "https://dev-static.hiapi.ai/model-showcases/fashn-tryon-v1.6/2026/10/20/1792477400517-e3ec2addf4b078a9-fashn-input-trousers-hiapi.jpg",
    "category": "bottoms",
    "mode": "balanced",
    "garment_photo_type": "model",
    "moderation_level": "permissive",
    "segmentation_free": true,
    "output_format": "png"
  }
}

平铺上装试穿

用挂拍白 T 作为 flat-lay 服装图，输出 972 × 1296。

请求体⧉

{
  "model": "fashn-tryon-v1.6",
  "input": {
    "model_image": "https://dev-static.hiapi.ai/model-onboarding/fashn-tryon-v1.6/2026/10/19/1792426518394-764c4dd31c38a98f-fashn-person.webp",
    "garment_image": "https://dev-static.hiapi.ai/admin-assets/2026/10/20/1792460217068-8a3b142473db580e-fashn-input-tee-flatlay.jpg",
    "category": "tops",
    "mode": "balanced",
    "garment_photo_type": "flat-lay",
    "moderation_level": "permissive",
    "segmentation_free": true,
    "output_format": "png"
  }
}

获取结果

1. 提交成功后立即返回 taskId（不等待生成完成）。
2. 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
3. status=success 后，从返回的 output[].url 下载图片。
4. 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

FASHN Try-On v1.6 需要写提示词吗？

不需要。它只接收人物照片和服装图，试穿效果由两张图片和可选的类别、模式参数决定。

必须同时传两张图吗？

是的。model_image 和 garment_image 都是必填；缺少任意一张，请求会返回参数校验错误。

支持哪些服装类别？

支持上装、下装和连体装，也可以选择自动识别。类别不确定时先用自动；识别不准时再明确指定。

mode 怎么选？

performance 更快，适合批量预览；balanced 在速度和质量之间平衡；quality 更慢，适合最终出图。

平铺图和模特图要分别设置吗？

可以用 garment_photo_type 指定 model 或 flat-lay，也可以交给自动识别。平铺、挂拍和模特穿着的商品图都支持。

输出是什么尺寸和格式？

每次返回一张竖版图片，尺寸随人物图比例变化。本次实测：3:4 人物图输出 972 × 1296，2:3 人物图输出 768 × 1152。默认 PNG，也可以选择 JPEG；不要假设所有结果都是同一个像素尺寸。

为什么同一次输入的结果会变化？

生成带有随机性。传入固定的 seed 可以复现同一结果；换一个 seed 会得到不同版本。

人物照片有什么要求？

建议使用正面、单人、身体主要部位清晰可见的照片。人物过小、严重遮挡或多人合影会影响贴合效果。

保守内容审核会拦截什么？

conservative 会额外拦截内衣和泳装；常规服装图使用 permissive 即可。

下一步

• 获取 API Key
• 查看 FASHN Try-On v1.6 价格
• 对比 AI 图像 API
• 在线试用 Playground