Photta API
仅需一次 REST 调用，即可生成 AI 时尚摄影。
生成服装与珠宝的真人模特上身照，从平铺图中移除模特道具，并基于 Photta 的生产流水线构建您自己的 AI 时尚工作室 —— 异步 REST 端点、点数计费、cURL 优先文档。
功能特性
3
认证
Bearer
模式
异步 + 轮询
典型耗时
1–4 min
功能特性
三个端点，一个账户，点数余额通用。
每项功能共享相同的认证方式、轮询模式和错误响应结构 —— 只需学习一个，即可掌握全部。
虚拟试穿 (服装)
将平铺服装图放置在您选定的姿势、表情和体型的 AI 模特上。支持 6 种产品类型，5 种纵横比。
珠宝试穿
在专用珠宝模特上生成项链、戒指、手镯和耳环的特写镜头 —— 完美处理金属反射和微小表面。
隐形模特
从服装照片中剥离模特道具，并保持内部结构完整。提供空心模特或平铺效果，适合批量处理。
编程语言
暂无 SDK —— 而且您并不需要它。
三个可直接粘贴的演练示例，完全符合 Photta 当前推荐的最佳实践。
快速入门
从注册到生成首张图片仅需五分钟。
每项功能都遵循相同的模式：认证、提交、轮询。一通百通。
- 1在 ai.photta.app 注册并在开发者控制面板生成 live API 密钥。
- 2在 Authorization 请求头中携带密钥提交 POST 任务 —— API 会立即返回生成任务 ID。
- 3每 3 秒轮询一次相同的端点，直到 status 变为 completed，然后下载结果 URL。
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": ["..."],
"mannequin_id": "mnq_athena_ts",
"pose_id": "pose_standing_front",
"resolution": "2K"
}'常见问题
开发者在注册前经常询问的问题
什么是 Photta API？+
Photta API 是一项基于点数计费的 REST 服务，可根据您的产品照片生成专业时尚摄影。它与驱动 Photta 消费级应用的流水线完全相同 —— 涵盖虚拟服装试穿、珠宝试穿和隐形模特提取，并作为三个端点开放，供开发者在其上构建工具。
如何获取 API 密钥？+
在 ai.photta.app 注册，打开仪表盘的 Developers 部分，点击 Generate API key。您的 live 密钥以 `photta_live_` 开头，后跟 32 位十六进制字符。请将其保存在环境变量中 —— 切勿提交到源码控制系统，切勿在浏览器端暴露。
有免费额度吗？+
新账户会获得试用点数，可用于测试任何功能。准备好正式上线后，您可以订阅具有更高月度点数余额和更高速率限制（Starter 版 30/min，Pro 版 60/min）的方案。没有单次调用门槛；计费周期内未使用的点数不会过期。
生成速度有多快？+
试穿任务通常在 1.5 到 4 分钟内完成。隐形模特速度更快 —— 通常为 1 到 3 分钟。所有端点均为异步：POST 请求在 1 秒内返回任务 ID，您每隔 3 到 5 秒轮询一次直到任务完成。无需管理长时间持有的 HTTP 连接。
有官方的 Photta SDK 吗？+
目前还没有。文档路线图计划在达到 10 个活跃 API 客户时发布 Python SDK，达到 20 个时发布 Node.js SDK。在此之前，官方支持的集成路径是直接通过 cURL、Node 原生 fetch 或 Python requests 库调用 REST 接口 —— 本站提供了这三种方式的端到端文档。