考えられる原因と確認順序
エラー文に基づく確認事項です。アカウントへの接続や原因の確定は行っていません。同じエラーにも複数の原因があります。
利用環境を選び、エラーの意味と確認手順を調べます。
ルール確認日 · 2026-11-11公式ドキュメント
入力・コンテキストが長すぎる
- モデルのコンテキスト上限か、ファイルのサイズ上限かを確認します。
- システム指示・履歴・添付・ツール定義の合計と、出力用の余裕を確認します。
- 必要な内容を保存してから添付を減らすか分割します。履歴の圧縮方法は公式ガイドを確認してください。
残高・利用枠の確認
- API残高、キーの予算、プランの利用枠のどれかをエラー本文で確認します。
- 実際の接続先で請求情報を確認します。チャットの契約とAPI残高は通常別です。
- 料金と権限を確認してから入金・予算変更を判断してください。連続再試行は避けます。
認証情報の不一致
- キーの接続先が正しく、有効期限切れ・失効がないか確認します。
- 環境変数名、空白、読み込み場所を端末内で確認します。キーをサイトやログに貼らないでください。
- アカウント認証の場合は公式の再ログイン手順を使います。
モデル ID・接続先・権限
- 表示名ではなく、接続先の正式なモデル ID をコピーします。
- エンドポイントとAPI方式を確認します。集約サービスと開発元でIDが異なる場合があります。
- アカウント・地域・ツールで対応しているか確認します。404はパス誤りでも発生します。
リクエスト頻度・同時実行制限
- 本文を確認します。429だけでは残高不足と判断できません。
- リクエスト数・トークン数・同時実行上限を、ゲートウェイと接続先の双方で確認します。
- 並行数を減らしRetry-Afterを守ります。再試行は待機時間と上限を設定してください。
権限・利用条件
- アカウント権限、モデルの有効化、地域、組織ポリシーを確認します。
- サービス側の理由を確認します。コンテンツ制限と権限不足は別です。
- 公式手順に従うかサポートに問い合わせてください。制限を回避しないでください。
リクエスト形式・パラメータ
- 接続先のプロトコルとメッセージ形式を確認します。
- 指定された項目の型と値を確認し、任意の追加パラメータを一つずつ外します。
- 公式の最小例を自分の環境で確認してから機能を戻してください。
サーバー内部エラー
- APIサービスと上流モデルの公式稼働状況を確認します。500は通常サーバー側の処理エラーです。
- 再試行の前に本文と結果を確認し、処理や課金が済んでいないか確認します。
- 時間を置いて回数を制限して再試行します。続く場合は秘密情報を除いた時刻と要求IDをサポートに伝え、キーは送らないでください。
通信・タイムアウト・混雑
- 公式稼働状況を確認し、端末・プロキシ・API・上流モデルの問題を切り分けます。
- DNS・証明書・プロキシ設定を端末で確認します。証明書検証は無効にしないでください。
- タイムアウトでも処理・課金済みの場合があります。結果を確認してから再試行し、続く場合は時刻と秘密情報を除いた要求IDで問い合わせてください。