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')

機能

機能別エンドポイント一覧

メソッド、パス、クレジット、標準所要時間をAPIドキュメントからそのまま記載。このページの情報は、末尾に記載された日付時点でドキュメントと照合確認されています。

クイックスタート

サインアップから最初の画像生成まで5分。

すべての機能が同じパターンに従います:認証、送信、ポーリング。一度覚えれば応用できます。

  1. ステップ 1: ai.photta.appでサインアップし、開発者ダッシュボードから本番用APIキーを生成します。

  2. ステップ 2: Authorizationヘッダーにキーを含めてジョブをPOSTします — APIは直ちにgeneration IDを返します。

  3. ステップ 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つすべてについて、全機能のエンドツーエンドな実装がこのサイトに記載されています。

リファレンス

何度も開くことになるドキュメントの主要部分。

このページに記載されている数値はすべて以下に基づきます: Photta APIドキュメント · 確認済み

5分でAPIを試す

Photta APIキーを生成し、上記のcURLスニペットを貼り付ければ、コーヒーが淹れ終わる前に最初のモデル着用画像が手に入ります。

  • 8 件の機能
  • 600 リクエスト/分
  • Bearerキー
  • 非同期、ポーリング