隐形模特 · 功能特性
隐形模特 API — Photta
从服装照片中剥离模特道具，并完全保留内部构造 —— 缝合线、衬里、标签。支持空心模特或平铺效果，支持批量处理，2K 分辨率 4 点数。
一句话介绍
Photta 的隐形模特 API 接收一张穿着模特道具的服装照片，并返回一张隐形模特图片，其中服装内部细节被重新构建。向 `/api/v1/ghost-mannequin` 发送 POST，包含 `product_image_url`、`style`（hollow_man 或 flat_lay）和分辨率。每 3 秒轮询一次 `/api/v1/ghost-mannequin/:id` 直至 status 变为 `completed`。
curl -X POST https://ai.photta.app/api/v1/ghost-mannequin \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_image_url": "https://example.com/tshirt-on-model.jpg",
"style": "hollow_man",
"resolution": "2K"
}'预期效果
Typical completion
1–3min
2K / 4K credits
4 / 6
Styles
2
Batch-ready
yes
端到端代码
选择您的编程语言
相同的 REST 约定；隐形模特端点还支持针对大批量目录运行的批量处理。
工作原理
照片输入，隐形模特照片输出
上传源图，选择样式，提交，轮询，下载。
- 01
步骤 1
生成 API 密钥
隐形模特使用与 Photta 其他功能相同的凭据 —— 密钥通用，点数余额通用。
- 02
步骤 2
上传源照片
您可以在 `product_image_url` 中传递公共 URL，或先通过 `/api/v1/uploads` 上传字节流。端点接受 JPG、PNG 和 WebP 格式。
- 03
步骤 3
提交隐形模特任务
向 `/api/v1/ghost-mannequin` 发送 POST，包含 `product_image_url`、`style`（hollow_man 或 flat_lay）和 `resolution`。如果您希望在任务完成时收到推送，可以传递 `webhook_url` —— 轮询仍是主要的获取路径。
- 04
步骤 4
轮询直至任务完成
每 3 秒调用一次 GET `/api/v1/ghost-mannequin/:id`。隐形模特的速度通常比试穿快 —— 约为 1 到 3 分钟 —— 因为不需要渲染真人模特。
- 05
步骤 5
下载并持久化
输出为 PNG 格式，移除了模特并重建了服装内部细节。非常适合详情页隐形模特图、具有 3D 感的产品画廊和平铺插入图。
开发者常见问题
开发者上线隐形模特前常问的问题
什么是隐形模特摄影？+
这是一种详情页展示方式，服装看起来像是穿在隐形人身上，同时展示外形和内部结构。传统上这需要多张影棚照片后期缝合；Photta API 仅需一张穿着模特拍摄的照片即可在单次调用中完成。
隐形模特费用是多少？+
2K 分辨率 4 点数，4K 结果 6 点数 —— 每个档次都比试穿便宜 1 点数。失败的任务自动退款。
空心模特 (hollow-man) 和平铺 (flat-lay) 样式有什么区别？+
空心模特保留了模特道具的 3D 体态 —— 服装保持丰满度，肩部和袖部表现自然，内部细节被重建。平铺样式则将服装塌缩为干净的 2D 铺陈效果，适合胶囊系列或需要统一正面形状的平台展示。
可以批量处理多张照片吗？+
可以。向 `/api/v1/ghost-mannequin/batch` 发送包含源图片数组的 POST 请求。响应将返回一个 batch ID 以及每个子项的 generation ID。您可以轮询 `/api/v1/ghost-mannequin/batch/:id` 获取总体状态，也可以单独轮询每个子项。
它会保留内部缝合线和标签吗？+
会 —— 模型会重新构建服装内部（衣领内部、袖口内部、腰带衬里），而不是凭空幻想一个通用表面。原图中可见的标签和印标会尽可能保留。
如何轮询结果？+
每 3 秒调用一次 GET `/api/v1/ghost-mannequin/:id`。批量任务则轮询父级端点，它会返回总体进度以及按项目划分的详细结果。
隐形模特 · 功能特性
创建账户并获取 API 密钥
Photta 的隐形模特 API 接收一张穿着模特道具的服装照片，并返回一张隐形模特图片，其中服装内部细节被重新构建。向 `/api/v1/ghost-mannequin` 发送 POST，包含 `product_image_url`、`style`（hollow_man 或 flat_lay）和分辨率。每 3 秒轮询一次 `/api/v1/ghost-mannequin/:id` 直至 status 变为 `completed`。