FASHN

FASHN Tryon v1.6

fashn-tryon-v1.6

虚拟试衣模型，输入人物图与服装图即可生成模特上身效果，原生输出 864x1296，支持平铺图输入与三档质量模式

fashn-tryon-v1.6

试用 fashn-tryon-v1.6

输入

作品灵感

查看全部作品

输出

image

填写参数并生成，结果会显示在这里。

价格

fashn-tryon-v1.6 每张

单价	$0.1072

定位简介

fashn-tryon-v1.6 是面向服装电商与视觉内容生产的虚拟试衣图像模型：输入一张人物照与一张服装商品图，输出模特穿着该服装的合成图。相比上一代，原生输出分辨率提升至 864x1296，对面料纹理、图案与文字等细节的还原更清晰，光照表现更自然。适合需要在商品详情页、营销素材或设计验证环节批量产出上身效果图的开发者与电商团队。

核心亮点

原生 864x1296 分辨率输出——较上一代提升约 50%，面料纹理、图案与文字细节在详情页尺寸下更清晰可用。
兼容模特图与平铺图两类服装素材——通过 garment_photo_type 指定 model、flat-lay 或 auto 自动识别，适配不同拍摄条件。
三档质量模式按需取舍——performance、balanced、quality 三档在出图速度与渲染精度之间切换，便于生产环境分级调用。
固定种子可复现结果——传入相同 seed 与相同输入可获得一致输出，便于批量生产中的结果复现与排查。

能力说明

人物与服装图合成试衣：提交人物图与服装图两个 URL 即可得到上身效果图，输出为 png 或 jpeg，可直接进入商品图或素材流程。

服装类别与拍摄形式适配：category 支持 tops、bottoms、one-pieces 与 auto 自动识别，garment_photo_type 区分模特上身图与平铺图，减少预处理工作。

出图质量控制：mode 选择速度优先或精度优先，moderation_level 可按业务要求屏蔽露骨内容，conservative 档还会拦截内衣与泳装类服装。

可复现的批量生成：固定 seed 后相同输入可重现结果，便于在生产流水线中定位问题与复跑失败样本。

适用场景

电商团队的服装商品上身图批量生产——以商品平铺图加模特图批量生成上身效果图，用于店铺详情页主图与款式展示。
服装设计打样阶段的视觉验证——用设计稿或样衣照片配合模特照快速出图，在投入实拍前确认版型与图案呈现效果。
营销素材的多款式快速出图——同一模特搭配多个款式分别生成图片，用于活动页、社媒投放等多变体素材制作。
平铺商品图转为模特上身展示——将已有的平铺或隐形衣架拍摄素材转换为模特穿着效果，盘活存量商品图库。

限制与选型建议

该模型面向固定分辨率的全身服装展示场景，输出尺寸不可任意调整。quality 模式下渲染精度更高但耗时更长，批量任务需在速度与效果之间分配档位；单次请求生成多个结果是提升可用率的常见做法，但会相应增加计费。conservative 审核档会拦截内衣与泳装类服装，涉及时应选择更宽松的档位。若业务更看重长时间运行的生产稳定性而非精度，需评估是否采用更成熟的上一代版本。

近期更新

查看更新日志 →

模型上新新模型 fashn-tryon-v1.6 虚拟试穿 Oct 19, 2026

常见问题

查看全部常见问题 →

FASHN Try-On v1.6 是什么？

它是一个专门的虚拟试穿模型。上传一张人物照片和一张服装图，模型会把服装穿到人物身上，输出一张竖版试穿图；不需要提示词，也不接收文字描述。输出适合直接进入商品详情页、社媒素材或投放预览。
需要写提示词吗？

不需要。它只接收人物照片和服装图，试穿效果由两张图片和可选的类别、模式、服装图类型参数决定。请求里不要额外带 prompt 字段，后端会按未知字段拒绝。
必须同时上传两张图吗？

是的。人物照片和服装图都是必填；缺少任意一张，Playground 和 API 都会在提交前拦下。上传两张图后运行按钮才会启用，API 会返回参数校验错误。
支持哪些服装类别？

支持上装（tops）、下装（bottoms）和连体装（one-pieces），也可以选择自动识别。类别不确定时先用自动；识别不准时再明确指定。混合品类目录建议按类别分组提交，减少自动识别带来的偏差。

提交生成任务

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

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：fashn-tryon-v1.6

routestring可选

当前固定值：default

inputobject必填

fashn-tryon-v1.6 和线路 default 的业务参数对象，见下方参数表。

modestring可选默认值: "balanced"

控制生成质量与速度的权衡模式，取字符串枚举值，默认 balanced；performance 更快、质量模式更慢但细节更丰富。

可选项：performancebalancedquality

seedinteger可选

随机种子，取整数；相同种子与相同输入可复现结果。

categorystring可选默认值: "auto"

服装类别，取字符串，默认 auto，即由服装图片自动检测类别。

可选项：topsbottomsone-piecesauto

model_imagestring必填minLength 1pattern ^https?://

穿着服装的人物照片，取 http(s) URL。

garment_imagestring必填minLength 1pattern ^https?://

待试穿服装的商品图，取 http(s) URL。

output_formatstring可选默认值: "png"

输出图片格式，取字符串，默认 png；png 质量最高，jpeg 速度更快。

可选项：pngjpeg

moderation_levelstring可选默认值: "permissive"

内容审核级别，取字符串，默认 permissive；permissive 拦截露骨内容，conservative 还会拦截内衣与泳装类内容。

可选项：nonepermissiveconservative

segmentation_freeboolean可选默认值: true

布尔开关，默认 true；开启后禁用对人物图像的人体解析（human parsing）。

garment_photo_typestring可选默认值: "auto"

服装图片类型，取字符串，默认 auto；model 表示模特穿着图，flat-lay 表示平铺或隐形人台图，auto 表示自动检测。

可选项：automodelflat-lay

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "fashn-tryon-v1.6",
  "input": {
    "mode": "balanced",
    "category": "auto",
    "model_image": "…",
    "garment_image": "…",
    "output_format": "png",
    "moderation_level": "permissive",
    "segmentation_free": true,
    "garment_photo_type": "auto"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "fashn-tryon-v1.6",
    input: {
      "mode": "balanced",
      "category": "auto",
      "model_image": "…",
      "garment_image": "…",
      "output_format": "png",
      "moderation_level": "permissive",
      "segmentation_free": true,
      "garment_photo_type": "auto"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "fashn-tryon-v1.6",
        "input": {
          "mode": "balanced",
          "category": "auto",
          "model_image": "…",
          "garment_image": "…",
          "output_format": "png",
          "moderation_level": "permissive",
          "segmentation_free": True,
          "garment_photo_type": "auto"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}