アパレル · 機能
バーチャル試着 API — Photta
一つのRESTコールで、平置きのアパレル写真をキャンペーン品質のモデル画像に変換します。非同期処理、生成時間は1回あたり 1.5–4 分、料金は 2K で 5 credits、4K で 7 credits です。
要約
Phottaのバーチャル試着APIは、平置きのアパレル画像、マネキンID、およびポーズIDを受け取り、2K または 4K のモデル着用写真を返します。`Authorization: Bearer photta_live_xxx` で認証し、`/api/v1/tryon/apparel` に POST し、返された生成IDを使用して同じエンドポイントを 3–5 秒 ごとにポーリングし、ステータスが `completed` になったら結果をダウンロードします。
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": ["https://example.com/dress.jpg"],
"mannequin_id": "mnq_athena_ts",
"pose_id": "pose_standing_front",
"resolution": "2K",
"aspect_ratio": "3:4"
}'期待される結果
Typical completion
1.5–4min
2K / 4K credits
5 / 7
Aspect ratios
5
Product types
6
エンドツーエンドのコード
言語を選択
同じエンドポイントに対し、3つの実行可能なウォークスルーを用意しました。すべてのスニペットはPhottaの公式ドキュメントに準拠しています。
仕組み
4つのAPIコール、1枚の商品写真
マネキンとポーズを選択し、ジョブを送信、完了までポーリングして、結果をダウンロードします。
- 01
ステップ 1
APIキーを生成する
ai.photta.app でサインアップし、Developers タブを開き、Generate API key をクリックします。ライブキーは `photta_live_` で始まります。キーは `PHOTTA_API_KEY` に保存し、決してコミットしないでください。
- 02
ステップ 2
マネキンとポーズを選択する
GET `/api/v1/mannequins` と `/api/v1/poses` で利用可能なオプションをリストします。ブランドに合うIDを選択してください。体型、表情、人種、ポーズのカテゴリでフィルタリング可能です。
- 03
ステップ 3
試着ジョブを POST する
`/api/v1/tryon/apparel` に `product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution`, `aspect_ratio` を含めて POST を送信します。APIは生成IDを含む 202 Accepted を返します。
- 04
ステップ 4
完了までポーリングする
3秒ごとに GET `/api/v1/tryon/apparel/:id` を実行します。`data.status` が `completed` になると、レスポンスに `output_url` と `thumbnail_url` が含まれます。ジョブの停滞によるリクエストのハングを防ぐため、試行回数に上限を設けてください。
- 05
ステップ 5
ダウンロードと保存
`output_url` からバイトデータを取得し、自社のオブジェクトストレージに保存します。CDNのURLは安定していますが、レンダリングをPhottaのCDNに依存すべきではありません。
開発者からのよくある質問
アパレル試着の導入前に開発者が抱く疑問
Phottaのバーチャル試着APIとは何ですか？+
平置きの商品画像とIDのペア（マネキン + ポーズ）を受け取り、フォトリアルなモデル着用画像を返すRESTエンドポイントです。Phottaのコンシューマー向けアプリと同じパイプラインを使用しています。`top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit` の6つの製品タイプをサポートしています。
1回あたりの料金はいくらですか？+
2K の結果で 5 credits、4K で 7 credits です。クレジットはサブスクリプションに含まれており、追加購入も可能です。生成に失敗した場合はクレジットは消費されず、返金されます。
生成にはどのくらい時間がかかりますか？+
エンドツーエンドで通常 1.5 から 4 分 です。POST リクエストは1秒以内に生成IDを返し、バックグラウンドでGPUの処理が行われている間にポーリングを行います。
どの製品タイプがサポートされていますか？+
以下の6つです：`top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`。それぞれ異なる `product_images` の形式を想定しています。例えば `top_and_bottom` の場合は、`top_image` と `bottom_image` 両方のURLが必要です。
自前のマネキンを使用できますか？+
はい。マネキン写真を `/api/v1/mannequins/upload` にアップロードするか、`/api/v1/mannequins/generate-model` で新しいAIマネキンを生成してください。返されたIDはそのまま試着リクエストに使用できます。
結果のポーリング方法は？+
GET `/api/v1/tryon/apparel/:id` を 3 から 5 秒 ごとに、`data.status` が `completed` または `failed` になるまで実行します。試行回数に上限（例：120回 × 3秒）を設けることで、ドキュメントに記載された時間を十分にカバーできます。
アパレル · 機能
アカウントを作成してAPIキーを取得
Phottaのバーチャル試着APIは、平置きのアパレル画像、マネキンID、およびポーズIDを受け取り、2K または 4K のモデル着用写真を返します。`Authorization: Bearer photta_live_xxx` で認証し、`/api/v1/tryon/apparel` に POST し、返された生成IDを使用して同じエンドポイントを 3–5 秒 ごとにポーリングし、ステータスが `completed` になったら結果をダウンロードします。