Photta API
Photta API RESTによるバーチャルtry-on、ゴーストマネキン、商品写真撮影
要約
Photta APIはクレジット制のREST APIです:機能のエンドポイントに商品写真をPOSTし、ステータスエンドポイントを数秒ごとにポーリングして、完成した画像をダウンロードします。8つの機能、1つのキー、1つのクレジット残高。
- 機能: 8 件の機能
- レート制限: 600 リクエスト/分
- 認証: Bearerキー
- パターン: 非同期、ポーリング
このページに記載されている数値はすべて以下に基づきます: Photta APIドキュメント · 確認済み
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_type": "top",
"product_images": [
"https://cdn.yourstore.com/products/shirt-front.jpg"
],
"product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
"product_category": "t_shirt",
"mannequin_id": "mnk_f3a9b1",
"pose_id": "pose_c2d4e5",
"background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
"lock_background": true,
"resolution": "2K",
"aspect_ratio": "3:4",
"body_size": "M",
"expression": "neutral",
"user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/tryon/apparel", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"product_type": "top",
"product_images": [
"https://cdn.yourstore.com/products/shirt-front.jpg"
],
"product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
"product_category": "t_shirt",
"mannequin_id": "mnk_f3a9b1",
"pose_id": "pose_c2d4e5",
"background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
"lock_background": true,
"resolution": "2K",
"aspect_ratio": "3:4",
"body_size": "M",
"expression": "neutral",
"user_instruction": "Keep the collar pattern crisp and centered."
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/tryon/apparel",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"product_type": "top",
"product_images": [
"https://cdn.yourstore.com/products/shirt-front.jpg"
],
"product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
"product_category": "t_shirt",
"mannequin_id": "mnk_f3a9b1",
"pose_id": "pose_c2d4e5",
"background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
"lock_background": True,
"resolution": "2K",
"aspect_ratio": "3:4",
"body_size": "M",
"expression": "neutral",
"user_instruction": "Keep the collar pattern crisp and centered."
},
)
data = res.json()["data"] # data["id"], data["status"]機能
機能別エンドポイント一覧
メソッド、パス、クレジット、標準所要時間をAPIドキュメントからそのまま記載。このページの情報は、末尾に記載された日付時点でドキュメントと照合確認されています。
- POST/api/v1/tryon/apparel
バーチャル試着(アパレル)
平置きの衣服画像を、指定した表情や体型のAIマネキンに合成します。4種類の製品タイプ、5種類のアスペクト比に対応。
2Kで5 credits · 4Kで6 credits1.5–4 min
エンドポイントを見る - POST/api/v1/tryon/jewelry
ジュエリー試着
ネックレス、リング、ブレスレット、ピアスのタイトクロップ接写を専用のジュエリーマネキンで実現 — 反射や微細な表面も忠実に再現。
2Kで5 credits · 4Kで6 credits1.5–4 min
エンドポイントを見る - POST/api/v1/ghost-mannequin
ゴーストマネキン
衣服写真からマネキンを除去し、内側の構造をそのまま保持します。3Dまたは平置きの仕上げに対応し、バッチ処理にも最適。
2Kで4 credits · 4Kで5 credits1.5–4 min
エンドポイントを見る - POST/api/v1/ghost-mannequin/batch
バッチゴーストマネキン
ラック全体の衣服写真を1回のリクエストで送信し、単一のバッチIDでポーリング可能。各画像は個別に課金および追跡されます。
2Kで4 credits · 4Kで5 credits1.5–4 min per image
エンドポイントを見る - POST/api/v1/eyewear-studio
アイウェアスタジオ
製品写真のフレームを忠実に維持しながら、メガネやサングラスをモデルのクローズアップ写真としてレンダリング。
2Kで5 credits · 4Kで6 credits20–60 sec
エンドポイントを見る - POST/api/v1/detail-photos
ディテール写真
1枚の製品写真からステッチ、生地、金属パーツ、ラベルのクローズアップを生成。撮影推奨エリアをアナライザーが提示します。
3 credits20–60 sec
エンドポイントを見る - POST/api/v1/mannequins/generate
マネキン生成
オプションを指定して独自のアパレルやジュエリー用マネキンを生成し、そのIDを各試着リクエストで再利用できます。
4 credits30-60s
エンドポイントを見る - POST/api/v1/workflows/{workflow_id}
ワークフロー
ジュエリーのヒーローショットなどのプリセットワークフローを1回のリクエストで実行し、完成した画像セットを取得します。
2Kで4 credits · 4Kで5 credits20–60 sec / image
エンドポイントを見る
言語
SDKはまだありません — そして不要です。
Phottaの公式ドキュメントが現在推奨する内容と完全に一致する、そのまま貼り付けて使える3つのウォークスルー。
クイックスタート
サインアップから最初の画像生成まで5分。
すべての機能が同じパターンに従います:認証、送信、ポーリング。一度覚えれば応用できます。
ステップ 1: ai.photta.appでサインアップし、開発者ダッシュボードから本番用APIキーを生成します。
ステップ 2: Authorizationヘッダーにキーを含めてジョブをPOSTします — APIは直ちにgeneration IDを返します。
ステップ 3: ステータスがcompletedに切り替わるまで同じエンドポイントを3秒ごとにポーリングし、生成結果のURLをダウンロードします。
よくある質問
サインアップ前に開発者が確認する事項
Photta APIとは何ですか?
PhottaのAPIは、商品写真からプロ仕様のファッション写真を生成するクレジット制のRESTサービスです。Phottaのコンシューマー向けアプリを支えるパイプラインと同じものであり、バーチャルアパレルtry-on、ジュエリーtry-on、ゴーストマネキン抽出など、開発者が独自のツールを構築できるよう8つの機能として公開されています。
APIキーの取得方法は?
ai.photta.appでサインアップし、ダッシュボードの開発者セクションを開き、「Generate API key」をクリックします。本番キーは`photta_live_`で始まり、その後に32文字の16進数が続きます。環境変数に保存し、ソース管理にコミットしたりブラウザに送信したりしないでください。
無料枠はありますか?
新規アカウントには、任意の機能に使用できるトライアルクレジットが付与されます。本番運用の準備ができたら、月間クレジット枠の大きいプランをご契約ください。レートリミットは全プラン共通で、APIキーごとに1分あたり600リクエストです。コールごとの最低利用要件はありません。
生成速度はどのくらいですか?
Try-onおよびゴーストマネキンのジョブは通常1.5〜4分以内で完了します。アイウェア撮影、ディテール写真、ワークフロー画像は20〜60秒、マネキン生成は30〜60秒です。すべての生成エンドポイントは非同期です:POSTを実行すると直ちにgeneration IDが返され、ジョブが終了するまで3〜5秒ごとにポーリングします。維持し続けるべき長時間HTTP接続はありません。
公式のPhotta SDKはありますか?
まだありません。サポート対象の統合方法は、cURL、Nodeのネイティブfetch、またはPythonのrequestsライブラリによる直接のREST接続です — 3つすべてについて、全機能のエンドツーエンドな実装がこのサイトに記載されています。
リファレンス
何度も開くことになるドキュメントの主要部分。
リファレンス
5 分以内に最初の Photta 画像を生成。
サインアップ、API キーの生成、最初の cURL 呼び出しの実行、完了までのポーリング、結果の保存。エンドツーエンドで文書化された 5 つのステップ。
読むリファレンス
Photta API の認証
Photta API に対する認証方法:Authorization ヘッダー、キーのプレフィックス、キーの作成場所、および安全なローテーション方法について説明します。
読むリファレンス
Photta API の料金体系
Photta APIの各endpointにおける2Kおよび4Kでのcredits消費量、請求と返金の仕組み、無料のendpoint一覧。画像単位の金銭的価格設定はありません。
読むリファレンス
Photta APIのレートリミット
Photta APIのレートリミット、ウィンドウ幅、Retry-Afterヘッダー、ポーリング間隔、プラン別の同時実行上限など、APIドキュメントに記載された仕様です。
読むリファレンス
Photta APIのエラー
ステータスコード別のPhotta APIエラータイプ一覧、エラーボディの構造、およびリトライすべき障害。
読むリファレンス
Photta API リソースエンドポイント
マネキン、ポーズ、背景、フットウェア、ブランドラベルの一覧取得、独自アセットのアップロード、クレジット残高の確認。すべての生成を支えるルックアップAPI群です。
読むガイド
バーチャルtry-on APIとは?
バーチャルtry-on APIは、1枚の商品写真から衣服を着用したモデルの画像をレンダリングします。必要な入力、返却される出力、費用、および実行時間について説明します。
読むガイド
ゴーストマネキンAPIとは?
ゴーストマネキンAPIは、衣服の写真からマネキンを除去し、内側を再構成します。必要な入力、返されるデータ、およびコストについて解説します。
読むガイド
FASHNからPhottaへの移行
仮想try-onの統合環境をFASHNからPhottaへ移行する際の変更点:認証、リクエストボディ、polling、およびcreditsの消費方式。
読む実装
Photta APIで構築する
Photta API向けの8つのエンドツーエンドレシピ:try-onアプリ、Shopifyアプリ、WooCommerceプラグイン、Djangoワーカー、カタログの一括処理、ノーコード自動化。
読む比較
優れたバーチャルtry-on API
5つのバーチャルtry-on API(Photta、FASHN、FitRoom、Pixazo、Ayna)の仕組み。各ベンダーが公開している情報、非公開の情報、および詳細の確認先。
読む
このページに記載されている数値はすべて以下に基づきます: Photta APIドキュメント · 確認済み