リファレンス · エラー

Photta APIのエラー 全エラータイプと対処法

要約

Photta APIのすべての失敗レスポンスは同一の構造を返します：ステータス、`error.type`、メッセージ、および`request_id`。429はRetry-Afterヘッダーの待機後に、5xxはバックオフを挟んでリトライしてください。400、401、402はクライアントコード側で修正する必要があります。

APIキーを取得ドキュメントを見る
  • エラー: 7 種類のエラータイプ
  • Retry-After: Retry-After: 30s
  • 制限: 600 リクエスト/分

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

エラータイプ

APIドキュメントに掲載されている完全なリスト。

400invalid_request_error
The request is malformed or contains invalid parameters.
401authentication_error
The API key is missing, invalid, or expired.
402insufficient_credits_error
Your account does not have enough credits.
404not_found_error
The requested resource does not exist.
409conflict_error
The request conflicts with current state — e.g. your concurrent-batch cap is reached.
429rate_limit_error
Too many requests. Slow down and retry.Retry-After: 30
500api_error
An internal server error occurred. Retry later.

エラーの構造

どのような問題が発生した場合でも、すべてのendpointで共通のエラーエンベロープが返されます。

{
  "error": {
    "type": "rate_limit_error",
    "message": "Rate limit exceeded."
  },
  "request_id": "req_xxxxxxxx"
}

エラーハンドリング

  • Retry-Afterを遵守する

    429レスポンスにはRetry-Afterヘッダーが含まれます。指定された秒数待機した後、エクスポネンシャルバックオフでリトライしてください。即時リトライは次のウィンドウをさらに遅らせるだけです。

  • 失敗時のcredits返還

    受付後に失敗した生成のcreditsは自動的に返還されるため、リトライによって二重請求されることはありません。

  • request_idを記録する

    すべてのレスポンスに`request_id`が含まれます。これをログに記録してください。サポートが無数のログから特定のエラーを迅速に特定するための最短の手がかりとなります。

  • 409はキューのシグナル

    コンフリクトは、ご利用のプランにおける同時実行バッチの上限に達したことを意味します。処理中のバッチが完了するまでポーリングを続け、その後に再送信してください。リクエストを乱発しないでください。

APIエラーに関するFAQ

エラーボディの構造

`request_id`と並んで、`type`および`message`を含む`error`オブジェクトが返されます。typeは固定の機械可読な値です。messageは人間向けのものであり、変更される可能性があります。

リトライすべきエラー

Retry-Afterの秒数を待機した後の429、およびエクスポネンシャルバックオフを伴う5xxです。400、401、402は、クライアント側のリクエストを変更しない限り同じエラーになります。

402の意味

`insufficient_credits_error` — アカウントのcredits残高が、その呼び出しまたはバッチ全体の予約分に対して不足しています。生成は実行されず、請求も発生しません。

エラーの報告方法

`request_id`、エンドポイント、発生時刻を送信してください。この3つの情報で正確な呼び出しを特定できるため、調査に画像自体は不要です。

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

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

5分でAPIを試す

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

アカウントを作成してAPIキーを取得API
  • 7 種類のエラータイプ
  • Retry-After: 30s
  • 600 リクエスト/分