服装 · 功能特性
虚拟试穿 API — Photta
单次 REST 调用即可将平铺服装照片转化为电商级别的模特展示图。异步处理，单次生成 1.5–4 分钟，2K 分辨率 5 点数，4K 分辨率 7 点数。
一句话介绍
Photta 的虚拟试穿 API 接收平铺服装图、模特 ID 和姿势 ID，然后返回一张 2K 或 4K 的模特实拍图。您需要通过 `Authorization: Bearer photta_live_xxx` 进行认证，向 `/api/v1/tryon/apparel` 发送 POST 请求，每隔 3–5 秒使用返回的任务 ID 轮询该端点，当 status 变为 `completed` 时下载结果。
curl -X POST https://ai.photta.app/api/v1/tryon/apparel \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_type": "dress",
"product_images": ["https://example.com/dress.jpg"],
"mannequin_id": "mnq_athena_ts",
"pose_id": "pose_standing_front",
"resolution": "2K",
"aspect_ratio": "3:4"
}'预期效果
Typical completion
1.5–4min
2K / 4K credits
5 / 7
Aspect ratios
5
Product types
6
端到端代码
选择您的编程语言
相同的端点，三个可运行的演练示例。每个代码片段均符合 Photta 官方文档规范。
工作原理
四次 API 调用，一张产品图
选择模特和姿势，提交任务，轮询至完成，下载结果。
- 01
步骤 1
生成 API 密钥
在 ai.photta.app 注册，打开 Developers 选项卡，点击 Generate API key。生产密钥以 `photta_live_` 开头。将其存入 `PHOTTA_API_KEY` —— 切勿提交到代码库。
- 02
步骤 2
选择模特和姿势
通过 GET `/api/v1/mannequins` 和 `/api/v1/poses` 获取可用选项。选择符合您品牌的 ID —— 体型、表情、族裔和姿势类别均可过滤。
- 03
步骤 3
提交试穿任务
向 `/api/v1/tryon/apparel` 发送 POST 请求，包含 `product_type`、`product_images`、`mannequin_id`、`pose_id`、`resolution`、`aspect_ratio`。API 将返回 202 Accepted 及任务 ID。
- 04
步骤 4
轮询直至任务完成
每 3 秒调用一次 GET `/api/v1/tryon/apparel/:id`。当 `data.status` 变为 `completed` 时，响应负载将包含 `output_url` 和 `thumbnail_url`。请设置最大轮询上限，防止任务卡死导致请求阻塞。
- 05
步骤 5
下载并持久化
从 `output_url` 获取字节流并存储在您自己的对象存储中。CDN URL 是稳定的，但您的前端展示不应长期依赖它。
开发者常见问题
开发者上线服装试穿前常问的问题
什么是 Photta 虚拟试穿 API？+
这是一个 REST 端点，输入平铺产品图和一组 ID（模特 + 姿势），返回一张照片级的真人上身图。它使用与 Photta 消费级应用相同的生产线。支持 6 种产品类型：上装、下装、套装、连衣裙、连体衣、连体短裤。
单次调用费用是多少？+
2K 结果 5 点数，4K 结果 7 点数。点数随订阅方案提供，也可随时加购。失败的生成不扣除点数 —— 会自动退还。
生成需要多长时间？+
端到端典型的完成时间为 1.5 到 4 分钟。POST 请求在 1 秒内返回任务 ID；当您在轮询时，GPU 计算在后台进行。
支持哪些产品类型？+
共 6 种：`top`、`bottom`、`top_and_bottom`、`dress`、`one_piece`、`jumpsuit`。每种类型对应的 `product_images` 参数结构略有不同 —— 例如 `top_and_bottom` 需要同时提供 `top_image` 和 `bottom_image` 的 URL。
可以使用我自己的模特吗？+
可以。通过 `/api/v1/mannequins/upload` 上传模特照片，或通过 `/api/v1/mannequins/generate-model` 生成新的 AI 模特。返回的 ID 可直接用于试穿请求。
如何轮询结果？+
每隔 3 到 5 秒调用一次 GET `/api/v1/tryon/apparel/:id`，直到 `data.status` 为 `completed` 或 `failed`。建议设置最大尝试次数 —— 120 次 × 3 秒的配置可以覆盖绝大多数文档约定的耗时窗口。
服装 · 功能特性
创建账户并获取 API 密钥
Photta 的虚拟试穿 API 接收平铺服装图、模特 ID 和姿势 ID，然后返回一张 2K 或 4K 的模特实拍图。您需要通过 `Authorization: Bearer photta_live_xxx` 进行认证，向 `/api/v1/tryon/apparel` 发送 POST 请求，每隔 3–5 秒使用返回的任务 ID 轮询该端点，当 status 变为 `completed` 时下载结果。