珠宝 · 功能特性
珠宝试穿 API — Photta
将项链、戒指、手镯和耳环放置在 AI 模特的特写镜头中，专门针对微小高反射表面进行了算法优化。点数价格与服装一致，采用相同的异步模式。
一句话介绍
Photta 的珠宝试穿 API 接收珠宝照片和 `jewelry_type`（项链、戒指、手镯或耳环），并返回一张模特佩戴特写图。携带 `Authorization: Bearer photta_live_xxx` 向 `/api/v1/tryon/jewelry` 发送 POST 请求，每 3 秒轮询一次任务 ID，当 status 变为 `completed` 时下载结果。
curl -X POST https://ai.photta.app/api/v1/tryon/jewelry \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jewelry_type": "necklace",
"jewelry_images": ["https://example.com/necklace.jpg"],
"mannequin_id": "mnq_jewelry_close_01",
"resolution": "2K",
"aspect_ratio": "1:1"
}'预期效果
Typical completion
1.5–4min
2K / 4K credits
5 / 7
Jewelry types
4
Close-up mannequins
built-in
端到端代码
选择您的编程语言
相同的三套演练代码 —— 只需更换端点和请求体即可。
工作原理
针对细微、高反射物品优化的服装试穿流程
选择特写模特，提交，轮询，下载。
- 01
步骤 1
生成 API 密钥
流程与服装相同 —— ai.photta.app → Developers → Generate API key。一个密钥通用所有端点；一个点数余额覆盖所有功能。
- 02
步骤 2
选择特写模特
过滤 `/api/v1/mannequins?jewelry_type=necklace`（或戒指/手镯/耳环） —— Photta 维护了一组专门构建的特写模特，其皮肤纹理针对微小金属和宝石进行了优化。
- 03
步骤 3
提交珠宝试穿任务
向 `/api/v1/tryon/jewelry` 发送 POST，包含 `jewelry_type`、`jewelry_images`、`mannequin_id`、`resolution`、`aspect_ratio`。服务会自动根据珠宝类别调整放置比例。
- 04
步骤 4
轮询直至任务完成
每 3 秒调用一次 GET `/api/v1/tryon/jewelry/:id`。响应结构与服装完全一致 —— `data.status`、`data.output_url`、`data.thumbnail_url`。
- 05
步骤 5
下载并持久化
紧凑的 1:1 裁剪最适合详情页缩略图；较宽的纵横比适用于画报展示。请自行存储图片，不要直接链接到 CDN。
开发者常见问题
开发者上线珠宝试穿前常问的问题
支持哪些珠宝类型？+
四个明确类别：项链 (necklace)、戒指 (ring)、手镯 (bracelet)、耳环 (earrings)。每个类别都有专属的特写模特和针对该外形优化过的放置逻辑。戒指和耳环在 1:1 比例下效果最好；项链在 3:4 比例下表现出色。
珠宝试穿的费用是多少？+
与服装相同：2K 分辨率 5 点数，4K 分辨率 7 点数。失败的任务自动退款。使用特写模特库无额外费用。
珠宝端点与服装端点有何不同？+
认证、轮询模式和响应结构完全相同 —— 区别仅在于请求体。您发送的是 `jewelry_type` 和 `jewelry_images` 而非 `product_type` 和 `product_images`，并且选择的是针对珠宝类别过滤的模特。其他（分辨率、纵横比、点数）均通用。
可以上传我自己的珠宝模特吗？+
可以 —— `/api/v1/jewelry-mannequins/upload` 接受自定义特写参考图，`/api/v1/jewelry-mannequins/generate` 通过提示词生成新模特。两者都会返回一个 ID 供试穿请求使用。
如何处理金属反射和宝石？+
特写处理管线包含高光和微几何元数据。金、银和镜面抛光铂金能得到正确渲染，不会出现通用试穿管线中常见的重影或色散问题。推荐使用纯净的影棚背景以获得最佳效果。
如何轮询结果？+
每 3 到 5 秒调用一次 GET `/api/v1/tryon/jewelry/:id`。status 生命周期与服装一致：`processing` → `completed` 或 `failed`。绝大多数任务在 1.5 到 4 分钟窗口内完成。
珠宝 · 功能特性
创建账户并获取 API 密钥
Photta 的珠宝试穿 API 接收珠宝照片和 `jewelry_type`（项链、戒指、手镯或耳环），并返回一张模特佩戴特写图。携带 `Authorization: Bearer photta_live_xxx` 向 `/api/v1/tryon/jewelry` 发送 POST 请求，每 3 秒轮询一次任务 ID，当 status 变为 `completed` 时下载结果。