リクエストの調査

AI APIエラー：401、429、5xx、タイムアウト

OpenAI、Claude、Gemini APIの認証、割当、頻度制限、一時的失敗を区別し、再試行判断前に詳細を確認。

作成者：IsAnythingDown確認日 2026-10-06Markdownを読む ↗

簡潔な回答

APIエラーだけでは提供元の障害を証明できません。エラー本文とリクエストIDを読み、該当する状態コンポーネントを確認してください。認証や請求の問題には設定変更が必要です。一時的な失敗には制限付き再試行が適する場合があります。

表で最初の確認を選びます。正確な意味・対処は提供元、エンドポイント、エラー本文によります。

表示内容	初回チェック	証明できないこと
400 / 404 / 413	リクエスト形式、エンドポイント、資源、サイズ。提供元エラーを確認	サービス全体の障害
401 / 403	認証情報、アクセス権限、提供元固有の制限	全ユーザーが遮断されていること
429	制限ヘッダー、割当、クレジット、支出上限	即時再試行が成功すること
500 / 503 / 529	提供元エラー詳細と対象公式コンポーネント	確認済みの世界規模のインシデント
タイムアウト／接続エラー	クライアント期限、DNS、TLS、プロキシ、リクエスト時間	失敗を起こした側

HTTP 429だけでなくerror.codeを確認。OpenAIは頻度制限と残高不足、組織・プロジェクト上限を区別します。請求・割当エラーは再試行では直りません。一時的制限や過負荷ではRetry-Afterに従い再試行を制限してください。

APIコンポーネントはOpenAI API項目を使います。ChatGPTアプリはAPI結果や特定GPTモデル健全性を確認できません。

Claudeは529を過負荷、401を認証失敗、403を権限失敗と定義します。429はレート制限や支出上限の場合があります。利用階層の支出上限429にはRetry-Afterがなく、利用再開まで失敗します。再試行方針の選択前にエラー全体を確認してください。

ClaudeではHTTP 200後にストリームエラーが起こり得ます。完了とエラーイベントを確認してください。ヘッダー受信だけでは生成成功を証明しません。

Googleは一時的エラーに上限付き指数バックオフとランダムな遅延を勧めています。API版、モデル、対応パラメーターも確認してください。開発者API自体の報告を参照し、GeminiアプリフィードはGemini APIやAI Studioを対象としません。

アプリの設計として最大試行回数と総時間予算の両方を設定し、SDKが行った再試行も含めてください。提供元が一時的とするエラーには指数バックオフとランダムな遅延を使い、該当する再試行ヘッダーに従ってください。

中断リクエストの再実行前に、既に出力、課金、後続処理が生じた可能性を確認してください。モデルの再試行とエージェントのツール操作の繰り返しは別の判断です。調査用にリクエストIDを残し、許容予算に達したら自動再試行を止めてください。

リクエストエラー専用ガイドを使ってください。リクエスト失敗の説明でアカウント上限監視ではありません。