503 No available accounts

このエラーの意味

503 Service Unavailableは、サーバーが一時的にリクエストを処理できないことを示します。AI API中継サービスでNo available accountsが付く場合、原因はさらに限定されます。ゲートウェイが、利用可能な上流アカウント、プロバイダー、グループ、モデルルートを見つけられなかったという意味です。

これは401とは異なります。401は認証失敗です。503 No available accountsでは認証に成功していても、その後ろにあるルーティング層に利用できる接続先がない場合があります。

主な原因

1. 中継サービスのアカウントプールが満杯で、上流アカウントがクールダウン中、レート制限中、無効化済み、一時的に利用不可になっている。
2. 特に長いコンテキスト、thinking、opus、入力トークン数の多いリクエストで、選択したモデルがモデル単位の上限に達した。
3. APIキーが属するグループに利用可能なプロバイダーが紐付いていない、または上流アカウントがキーとは別のグループに割り当てられている。
4. サービスが一部ルートをClaude Codeなど特定のクライアントだけに制限し、CC Switch、リバースプロキシ、非公式クライアントを拒否している。
5. セルフホスト型ゲートウェイまたは二段目のプロキシにルーティング不具合があり、1つの上流でアカウントが見つからないときに、スティッキーセッションやエラー処理が別のアカウントへフェイルオーバーできない。

解決方法

1. 再試行する前に30〜120秒待ちます。503は一時的な容量不足のシグナルとして扱い、短い間隔で再試行し続けないでください。
2. 同じベースURL、APIキー、モデルで可能な限り小さいリクエストを送信します。これも503になる場合は、サービスの稼働状況、アカウントプール、グループ、モデルの可用性を確認してください。
3. 一般的なモデルをテストします。長いコンテキスト、thinking、opus、特殊ルートだけが失敗し、通常モデルが動作する場合は、モデル単位の容量またはクールダウンがボトルネックである可能性があります。
4. サービスのダッシュボードで、APIキーのグループ、プロバイダーとの紐付け、残高、1日あたりのクォータ、クライアント制限を確認します。キーの再発行だけでは、利用できない上流プールは通常復旧しません。
5. CC Switch、リバースプロキシ、セルフホスト型ゲートウェイを使用している場合は、その層を一度迂回し、サービスのベースURLを直接テストします。二次ルーティング、スティッキーセッション、フォールバック失敗が、短時間の上流障害を増幅することがあります。

AI API中継サービス利用時の確認事項

ローカルツール、設定した中継サービス、その背後にある上流アカウントプールの3層を分けて確認します。

最小のcurlリクエストは成功してClaude Code、Codex、Cursorが失敗する場合は、ツールのプロファイル、モデル名、コンテキスト長、クライアント制限を確認してください。画面上の同時実行数が少なくても、コーディングエージェントの1回の呼び出しに長い履歴コンテキストが含まれる場合があります。

最小リクエストにも失敗する場合は、ローカル設定が原因ではない可能性が高くなります。APIキーを繰り返し編集するのではなく、サービスのステータスページ、告知、サポート窓口、アカウントプールの容量を確認してください。

サービスを変更するタイミング

最小リクエストが503を返し続ける、同じサービスで複数モデルを利用できない、またはサービス運営者がアカウントプールの飽和を認めた場合は、サービス変更を検討できます。

1つのモデルだけが失敗する場合は、先に別のモデルまたはグループを試してください。1つのクライアントだけが失敗する場合は、先にクライアント制限とベースURL設定を確認します。すべての503を「サイト全体が停止している」と判断するのは短絡的で、実際の設定やコンテキストの問題を解決しないままサービス間を移動することになりかねません。