トラブルシューティング

リクエストタイムアウト

LLMs Text

リクエストタイムアウトの対処

タイムアウトは、最初のバイトが来ない、timeout / response header timeout エラー、または最終的な 503 クールダウン応答として現れます。不正なトークンとは別物です。

想定される原因

  1. 長い reasoning または短い上流の混雑 — クールダウンとリトライ を参照。
  2. ローカルネットワーク / プロキシ — .com と .net を試す;企業プロキシと TLS 傍受ツールを確認。
  3. クライアントの timeout が短すぎる — 長いジョブはクライアント上限を上げ、bounded backoff を使う。
  4. 並列が多すぎる — 同時の Codex / Claude Code / バッチを 1–3 に減らす。

手順

  1. もう一方の中継ホストで一度リトライ(トークンは共通)。
  2. 同じモデルで極小プロンプトで再現。
  3. Status でメンテナンスの有無を確認。
  4. no_account_available / cooling down の場合は待つ — 連打リトライしない。
  5. 約 15 分後、時刻、モデル、ツール、trace_id(トークンは含めない)を support@4aicode.com へ。

401 / 429 とタイムアウト

ステータス意味ドキュメント
401認証失敗401
429クォータ / レート制限429
Timeout / 503ネットワーク、上流、クールダウンこのページ + クールダウン

関連