リファレンス · レートリミット

Photta APIのレートリミット 適切なポーリング方法

要約

Photta APIでは、APIキーごとに固定ウィンドウで毎分600リクエストが許可されます。429にはRetry-After: 30が含まれます。ジョブのポーリングは3秒間隔で行ってください。同時実行数はプランごとに制限されます。

APIキーを取得ドキュメントを見る
  • 制限: 600 リクエスト/分
  • Retry-After: Retry-After: 30s
  • 処理方式: 非同期、ポーリング

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

公開リミット

ドキュメントに記載されているレート、ウィンドウ、リトライ、画像サイズ、フォーマットの仕様。

制限

  • APIキーごとに毎分600リクエスト (固定ウィンドウ方式。制限値はすべてのプランで共通です)
  • 429にはRetry-After: 30 secondsが含まれます
  • 1画像あたり最大10 MB
  • フォーマット: JPEG, PNG, WebP
  • プランごとの同時実行バッチ数: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
  • ポーリングのみ — APIはWebhookを送信しません。

プラン別の同時実行数

送信に対して409が返されるまでに、同時に処理可能なバッチ数。

プラン別の処理中バッチ数

Free

同時実行数: 1

Hobby

同時実行数: 2

Seller

同時実行数: 3

Brand

同時実行数: 4

Studio

同時実行数: 6

リミット内に収めるためのベストプラクティス

  • 固定ウィンドウ方式

    リミットは固定ウィンドウ内でAPIキーごとにカウントされ、全プラン共通です。2つのキーを使用すれば、2倍の枠を利用できます。

  • 3秒ごとのポーリング

    APIはウェブフックを送信しないため、ポーリングが唯一の完了検知手段です。ドキュメントで推奨されている間隔は3秒ごとです。これより高頻度で実行すると、無意味なレスポンスでリクエスト枠を浪費することになります。

  • 指数バックオフを適用する

    429 の後は、Retry-After の秒数待機し、一定間隔でリトライするのではなく、失敗するたびに待機時間を延ばしてください。

  • バッチには個別の制限が適用される

    レートリミットはリクエスト数をカウントし、同時実行数の上限は処理中のワーク数をカウントします。上限を超えるバッチは 429 ではなく 409 を返します。

レートリミットに関するFAQ

レートリミットはいくつですか？

固定ウィンドウ方式で、API キーあたり毎分 600 リクエストです。ドキュメントにはすべてのエンドポイントで同じ数値が記載されています。

ジョブのポーリング頻度はどのくらいにすべきですか？

3 秒ごとです。Webhook は用意されていないため、ジョブの完了を確認するにはポーリングを行うことが仕様上指定された手順です。

一度にどれだけレンダリングできますか？

処理中のバッチ数はプランごとに上限が定められています：Free 1、Hobby 2、Seller 3、Brand 4、Studio 6。上限を超えたリクエストは 409 を返します。

429 が返されたらどうすべきですか？

Retry-After ヘッダーを読み取り、指定された秒数待機してから、指数バックオフを用いてリトライしてください。リクエストを破棄するのではなく、キューに登録してください。

エンドポイントとリファレンス

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

5分でAPIを試す

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

アカウントを作成してAPIキーを取得API
  • 600 リクエスト/分
  • Retry-After: 30s
  • 非同期、ポーリング