指南 · 隐形人台

什么是隐形人台 API? 隐形人台拍摄效果

一句话总结

隐形人台 API 接收穿着于人台上的服装照片,并返回移除了人台、重构了内部结构的同款服装图像,使衣物呈现出立体自立的形态。

  • 常规耗时: 1.5–4 min
  • Credits: 2K 分辨率 4 credits · 4K 分辨率 5 credits
  • 处理方式: 异步,轮询

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

简要概括

隐形模特摄影(也称镂空人台或隐形人台摄影)展示的是没有人体穿着却依然保持版型的服装。传统做法是通过后期将多张影棚拍摄底片拼接而成:先拍服装在人台上的效果,然后抠除人台,再将领口内侧和袖口内衬合成回去。

隐形模特 API 只需一次调用即可完成这一过程。你传入人台拍摄图,服务会自动去除人台结构并重构衣物内部可见区域——领口内侧、袖口内衬、裤腰——并返回成片。与 try-on 一样,该调用为异步机制:提交、轮询、下载。

这是服装品类标准的商品详情页处理方式,调用方多为商品目录团队和电商平台,他们需要让数千款商品保持视觉一致,而无需为每件衣服单独预订影棚档期。

实现该功能的 endpoint

读取自 Photta API 官方文档,非人工手写。

概览

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

隐形人台 API 的选型要点

  • 请求参数

    人台拍摄的服装图,可附带背面视角图。Photta 支持 JPEG、PNG 和 WebP 格式,单张图片上限 10 MB。

  • 成品呈现效果

    Photta 的 endpoint 接受 style 参数:3d 保留服装的立体空间感,flat_lay 则将其压平为干净利落的正向平铺效果。

  • 费用说明

    Photta 计费为 2K 分辨率 4 credits,4K 分辨率 5 credits——每个档位均比 try-on 少 1 credit,任务失败会自动退款。

  • 是否支持批量处理

    商品目录制作往往是整批交付,而非单件处理。Photta 提供了批处理 endpoint,接收数组格式输入,预先冻结 credits,并返回每个子项的状态。

发起首次请求

使用 cURL、Node.js 与 Python 的同等调用示例。

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
  "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
  "image_side": "front",
  "angle": "side",
  "style": "3d",
  "background_color": "white",
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "user_instruction": "closed front, cream interior lining",
  "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

关于隐形人台 API 的常见问题

什么是隐形模特图?

一种让服装呈现立体悬浮状态的商品图,无需显露人体或衣架即可保持版型。它能同时展示合身度与内部做工,因此是服装详情页的默认首选。

我需要向 endpoint 传入什么?

一张服装穿在人台上的照片。背面视角图为可选项,在服装敞开或双面可穿时有助于提升重构效果。

我应该选择 3d 还是 flat lay?

如果希望服装呈现穿着上身的效果(展现立体轮廓、肩线、袖形),选择 3d;若商品发布要求严格一致的正向平铺版型(电商平台常见规范),选择 flat_lay。

单张图片成本是多少?

在 Photta 上,2K 分辨率单张 4 credits,4K 分辨率单张 5 credits。在批处理中,整个运行周期的费用将按相同的单图单价预先冻结。

我可以处理整套商品目录吗?

可以,通过批处理 endpoint 即可完成。单批大小和并发批次数量均取决于你的订阅方案,因此超大目录可以拆分为一系列批次顺序执行。

试跑一件服装

输入一张照片,输出一张隐形人台成图。

  • 1.5–4 min
  • 2K 分辨率 4 credits · 4K 分辨率 5 credits
  • 异步,轮询