ジュエリー · 機能
ジュエリー試着 API — Photta
ネックレス、指輪、ブレスレット、ピアスをAIモデルの接写画像に配置します。微細で反射の強い表面に特化した処理が行われます。アパレルと同じ 2K/4K の料金体系と非同期パターンを採用しています。
要約
Phottaのジュエリー試着APIは、ジュエリーの写真と `jewelry_type` (necklace, ring, bracelet, earrings) を受け取り、モデルの接写写真を返します。`Authorization: Bearer photta_live_xxx` で `/api/v1/tryon/jewelry` に POST し、返されたIDを3秒ごとにポーリングして、ステータスが `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
エンドツーエンドのコード
言語を選択
アパレルと同じ3つのウォークスルー。エンドポイントとリクエストボディを差し替えるだけです。
仕組み
小さく反射の強いアイテムに最適化されたアパレルフロー
接写用マネキンを選択し、送信、ポーリング、ダウンロード。
- 01
ステップ 1
APIキーを生成する
アパレルと同じ流れです。ai.photta.app → Developers → Generate API key。1つのキーですべてのエンドポイントを利用でき、1つのクレジット残高がすべての機能をカバーします。
- 02
ステップ 2
接写用マネキンを選択する
`/api/v1/mannequins?jewelry_type=necklace` (または ring / bracelet / earrings) でフィルタリングします。Phottaは、金属や石の質感に合わせて最適化された接写用マネキンセットを維持しています。
- 03
ステップ 3
ジュエリージョブを POST する
`/api/v1/tryon/jewelry` に `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio` を含めて POST します。サービスはジュエリーのカテゴリに合わせて配置を自動調整します。
- 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 の4つのカテゴリです。各カテゴリには専用の接写用マネキンと、その形状に合わせて調整された配置アルゴリズムが用意されています。指輪とピアスは 1:1、ネックレスは 3:4 のアスペクト比で美しく見えます。
ジュエリー試着の料金はいくらですか？+
アパレルと同じく、2K で 5 credits、4K で 7 credits です。失敗したジョブは自動的に返金されます。接写用マネキンライブラリに追加料金はかかりません。
ジュエリーエンドポイントはアパレルと何が違いますか？+
認証、ポーリングパターン、レスポンス形式はすべて同じです。違いはリクエストボディにあります。`product_type` と `product_images` の代わりに `jewelry_type` と `jewelry_images` を送信し、ジュエリーカテゴリでフィルタリングしたマネキンを選択します。それ以外（2K/4K、アスペクト比、クレジット）は共通です。
自前のジュエリーモデルをアップロードできますか？+
はい。`/api/v1/jewelry-mannequins/upload` でカスタムの接写リファレンスを受け付け、`/api/v1/jewelry-mannequins/generate` でプロンプトから新しいモデルを生成できます。どちらも返されたIDを試着リクエストに使用できます。
反射する金属や宝石はどのように処理されますか？+
接写パイプラインは、鏡面ハイライトや微細な形状に関するメタデータを保持しています。金、銀、鏡面仕上げのプラチナも、汎用的な試着パイプラインで発生しがちなゴーストや色のにじみなく、正しくレンダリングされます。最良の結果を得るには、非常にクリーンなスタジオ背景を推奨します。
結果のポーリング方法は？+
GET `/api/v1/tryon/jewelry/:id` を 3 から 5 秒 ごとに実行します。ステータスのライフサイクルはアパレルと同じ `processing` → `completed` または `failed` です。ほとんどのジョブは 1.5 から 4 分 のウィンドウ内に収まります。
ジュエリー · 機能
アカウントを作成してAPIキーを取得
Phottaのジュエリー試着APIは、ジュエリーの写真と `jewelry_type` (necklace, ring, bracelet, earrings) を受け取り、モデルの接写写真を返します。`Authorization: Bearer photta_live_xxx` で `/api/v1/tryon/jewelry` に POST し、返されたIDを3秒ごとにポーリングして、ステータスが `completed` になったら結果をダウンロードします。