エラーと再試行
一時的な障害は再試行し、リクエストのエラーは修正してから再送信します。
呼び出しが失敗した場合は、再試行するかどうかを判断する前に、HTTP ステータス、機密情報をマスクしたエラー本文、リクエスト日時、エンドポイント、Model ID、取得できるリクエスト識別子を保存してください。
よくあるエラー
| 結果 | 最初に確認すること | すぐに再試行するか |
|---|---|---|
400 無効なリクエスト | JSON、Model ID、フィールドの型、モデルの対応状況 | いいえ。リクエストを修正します |
401 認証失敗 | API キー、Bearer の形式、認証情報の状態 | いいえ。認証情報を修正します |
403 アクセス制限 | アカウント、モデルの範囲、地域、アクセス元の制限 | いいえ。アクセス権を確認します |
404 パスまたはリソースが存在しない | API アドレス、エンドポイント、Model ID、タスク識別子 | いいえ。設定を見直します |
429 リクエスト過多 | リクエストレート、同時実行数、返されたレート制限の案内 | レートを下げて、回数を限定して再試行します |
5xx サービスエラー | リクエスト ID と、元のリクエストが実行されたかどうか | エラー内容に応じて、回数を限定して再試行します |
| タイムアウトまたは接続の中断 | ネットワーク、クライアントのタイムアウト、リクエストのステータス | やみくもに再試行しないでください |
| 残高または予算の不足 | 利用可能な残高、キーの予算、コスト保護 | 先に制限を解消します |
エラー本文とステータスコードは、実際の API レスポンスを基準にしてください。
再試行を設定する
回復する可能性のあるエラーだけを再試行し、試行回数と合計待機時間に上限を設定します。レスポンスに明示的な再試行の案内がある場合は、それに従ってください。
例:最大 3 回まで再試行し、約 1 秒、2 秒、4 秒ずつ待機して、わずかなランダム遅延を加えます。これはアプリケーション側の戦略の例です。プラットフォームの制限がこのタイミングで解除されることを保証するものではありません。SDK、アプリケーション、ゲートウェイで同時に無制限の再試行を有効にしないでください。
重複リクエストを避ける
クライアント側でタイムアウトした場合は、リクエストログで元のリクエストを確認します。画像生成や長時間実行されるタスクでは、再送信する前に、既存のリクエストまたはタスクの識別子を確認してください。冪等性のためのフィールドやヘッダーは、インターフェースが明示的に対応している場合にのみ使用します。
サポートに問い合わせる
リクエスト ID、リクエスト日時とタイムゾーン、Model ID、エンドポイント、HTTP ステータス、マスク済みのエラー、実施済みのトラブルシューティング手順を伝えてください。パスワード、認証コード、API キー全体、無関係な機密情報は絶対に送信しないでください。