指南 · 虚拟 try-on

什么是虚拟 try-on API？ 以及它的返回内容

一句话总结

虚拟 try-on API 接收服装照片，并返回模特穿着该服装的渲染图像。你只需 POST 该照片并附带 mannequin 和姿态参数，随后轮询任务状态，最后下载渲染结果即可。

获取 API Key阅读文档
  • 常规耗时: 1.5–4 min
  • Credits: 2K 分辨率 5 credits · 4K 分辨率 6 credits
  • 处理方式: 异步，轮询

本页所有数据均来自 Photta API 文档 · 已验证

简要概括

虚拟 try-on API 是一个将服装渲染到模特身上的 HTTP endpoint。你发送一张商品照片——通常是你现有的平铺图或人台图——该服务便会返回一张该服装的上身效果图。无需摄影棚，无需预约模特，更改配色时也无需重拍。

调用是异步的，因为渲染耗时超出了单个 HTTP 请求应当等待的范围。你通过 POST 提交服装以及所选模特和姿势，API 接受该任务并返回一个 id，随后你轮询 status endpoint 直至任务报告完成。生成的最终图像会以 URL 形式返回，供你自行下载和存储。

常见调用方包括：需要为从未进入摄影棚的商品生成模特图的目录团队、接收卖家平铺图的电商平台，以及让消费者能在品牌单一试衣模特之外的身型上查看服装效果的应用程序。

执行该任务的 endpoint

直接提取自 Photta API 文档，非手工编写。

概览

端点
POST /api/v1/tryon/apparel
身份验证
Bearer API 密钥
处理方式
异步 — 轮询状态端点
常规耗时
1.5–4 min
Credits
2K 分辨率 5 credits · 4K 分辨率 6 credits
宽高比
3:4 · 1:1 · 4:3 · 9:16 · 16:9
输入限制
单张图片最大 10 MB；支持 JPEG, PNG, WebP
幂等性
否

评估任何 try-on API 时的核心考量点

  • 发送内容

    服装照片需提供为 https URL 或 base64 data URI，外加所需的模特与姿势。Photta 支持 JPEG、PNG 和 WebP 格式，单图上限 10 MB。

  • 耗时说明

    处理耗时较长，无法在单个 Web 请求中同步完成。Photta 公布了每个 endpoint 的典型完成时间，并要求每 3 秒进行一次轮询——不提供 webhook。

  • 调用费用

    Photta 按次扣除 credits：服装 try-on 在 2K 分辨率下扣除 5 credits，在 4K 分辨率下扣除 6 credits；任务启动时扣款，任务失败时自动退款。

  • 限制规则

    已公布的 rate limit 为每个 key 每分钟 600 个请求，并按订阅方案对并发渲染量设有上限。在进行目录级批量处理前，这两项均值得参阅。

首次请求

使用 cURL、Node.js 和 Python 发起相同的调用。

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_type": "top",
  "product_images": [
    "https://cdn.yourstore.com/products/shirt-front.jpg"
  ],
  "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
  "product_category": "t_shirt",
  "mannequin_id": "mnk_f3a9b1",
  "pose_id": "pose_c2d4e5",
  "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
  "lock_background": true,
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "body_size": "M",
  "expression": "neutral",
  "user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

关于虚拟 try-on API 的常见问题

try-on API 返回什么内容？

一张由所选模特穿着该服装的图像，并在已完成的任务中以 URL 形式提供。请自行下载并存储——交付 URL 并非永久托管服务。

我需要提供模特照片吗？

不需要。Photta 提供了可供选择的人台图录，你也可以根据属性生成自定义模特或自行上传。服装照片是唯一必须提供的图像。

这与虚拟试衣间有何不同？

试衣间是面向消费者的前端功能。try-on API 则是其底层的渲染环节：输入一次调用，输出一张图像。你可以在其上构建试衣间，也可以单纯用它来制作目录商品图。

一次 try-on 调用费用是多少？

使用 Photta 时，2K 为 5 credits，4K 为 6 credits。失败的任务会退款，因此重试的成本就是重试本身。

生成一张图像需要多长时间？

endpoint 会公布其典型完成时间，任务也会报告自身的处理状态。请每 3 秒轮询一次，而非预设固定耗时。

阅读下一篇

本页所有数据均来自 Photta API 文档 · 已验证

使用您自己的商品图进行试穿

一次请求，一次轮询，一张成图。

创建账户并获取 API Key查看 endpoint
  • 1.5–4 min
  • 2K 分辨率 5 credits · 4K 分辨率 6 credits
  • 异步，轮询