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

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

作成者：IsAnythingDown. 確認日：2026-10-06.

正規ページ： https://isanythingdown.com/ja/guides/ai-api-error-codes

## 簡潔な回答

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

## エラー分類から確認

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

| 表示内容 | 初回チェック | 証明できないこと |
| --- | --- | --- |
| 400 / 404 / 413 | リクエスト形式、エンドポイント、資源、サイズ。提供元エラーを確認 | サービス全体の障害 |
| 401 / 403 | 認証情報、アクセス権限、提供元固有の制限 | 全ユーザーが遮断されていること |
| 429 | 制限ヘッダー、割当、クレジット、支出上限 | 即時再試行が成功すること |
| 500 / 503 / 529 | 提供元エラー詳細と対象公式コンポーネント | 確認済みの世界規模のインシデント |
| タイムアウト／接続エラー | クライアント期限、DNS、TLS、プロキシ、リクエスト時間 | 失敗を起こした側 |
- [OpenAI APIエラーコード](https://developers.openai.com/api/docs/guides/error-codes)
- [Claude APIエラー](https://platform.claude.com/docs/en/api/errors)
- [Gemini APIのトラブルシューティング](https://ai.google.dev/gemini-api/docs/troubleshooting)

## OpenAI：429は異なる制限の場合があります

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

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

- [OpenAI APIエラーコード](https://developers.openai.com/api/docs/guides/error-codes)
- [OpenAI APIコンポーネント報告](https://isanythingdown.com/ja/services/openai)

## Claude：過負荷と支出上限は別です

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

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

- [Claude APIエラー](https://platform.claude.com/docs/en/api/errors)

## Gemini：開発者エンドポイントを確認

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

- [Gemini APIのトラブルシューティング](https://ai.google.dev/gemini-api/docs/troubleshooting)
- [Gemini API / AI Studio公式状態](https://aistudio.google.com/status)

## 再試行予算を設定

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

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

- [OpenAI APIエラーコード](https://developers.openai.com/api/docs/guides/error-codes)
- [Gemini APIのトラブルシューティング](https://ai.google.dev/gemini-api/docs/troubleshooting)

## 特定応答を調査

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

- [AI APIエラー429](https://isanythingdown.com/ja/guides/ai-api-error-429)
- [AI APIエラー500](https://isanythingdown.com/ja/guides/ai-api-error-500)
- [AI APIエラー503](https://isanythingdown.com/ja/guides/ai-api-error-503)
- [AI APIエラー529](https://isanythingdown.com/ja/guides/ai-api-error-529)

## 関連サービスページ

- [OpenAI API](https://isanythingdown.com/ja/services/openai)
- [Claude](https://isanythingdown.com/ja/services/claude)
- [Gemini API / AI Studio](https://isanythingdown.com/ja/services/gemini-api)
- [OpenRouter](https://isanythingdown.com/ja/services/openrouter)

各項目に収集範囲を表示します。リンクされたサービスが自動収集されるとは限りません。

編集確認日はこのガイドに適用されます。リアルタイム報告の収集時刻はサービスページにあります。