EastX API エラー対処法｜402・429・403・5xx を切り分ける
残高、API キーの上限、レート制限、モデル権限とタイムアウトの確認手順を解説します。
EastX API エラーは原因ごとに切り分ける
API のエラーが出たら、繰り返し送信する前に HTTP ステータスとエラー種別を確認します。残高不足、モデル権限、URL の間違い、レート制限では対処が異なります。発生時刻、モデル ID、ステータス、エラー種別とリクエスト識別子を記録すると調査しやすくなります。
402：残高とキーの利用上限を確認する
insufficient_balance は残高を、cap_reached は API キーの利用上限を確認します。リクエスト前の残高チェックには入力と最大出力の見積もりが関係し、候補の予備ルートが影響することもあります。不要に大きい最大出力設定を見直し、残高またはキー上限を確認してから再試行してください。実際の請求は利用記録と照合します。
429：同時実行と再試行を整理する
キー単位の制限か tenant_rate_limit_exceeded かを確認します。SDK、クライアント、ジョブキューの複数箇所で再試行すると、送信数が増えることがあります。再試行する層を決め、Retry-After が返る場合はその指示に従い、回数と総待機時間を制限します。間隔にはランダムな待機を加え、バッチ処理はキューで同時実行を管理します。
401・403・404：接続設定を確認する
- 401：有効な EastX API キーが正しく設定されているか確認します。
- 403：キーの有効状態、期限、モデル権限と送信元 IP 制限を確認します。
- 404：モデル ID とエンドポイントを確認します。通常の Base URL は
https://api.eastx.ai/v1です。/v1や/chat/completionsの重複にも注意してください。
502・503・504 とタイムアウト
502 は上流側のエラーを示します。503 ではモデルの利用状態と利用可能なルートを確認してください。504 やクライアントのタイムアウトでは、応答を受け取れなかったことだけで処理が実行されなかったとは判断できません。
動画生成ですでにタスク ID がある場合は、同じタスクを照会します。pending_confirmation の状態で新しいタスクを繰り返し作成せず、元のタスクを確認してください。Agent のファイル操作や外部ツールも、再実行前に実行済みか調べます。
クライアント別に管理する
WorkBuddy、コーディングツール、テスト環境に別々の EastX キーを割り当て、利用上限やモデル権限を設定すると、問題のある利用を切り分けやすくなります。サポートには時刻、モデル、エラー種別と伏せ字にした識別子を伝え、完全な API キーは共有しないでください。
設定と制限を確認した後にモデルを変更する場合は、代替モデルが必要なツール、コンテキスト長、出力形式に対応するか確認し、実際の作業結果も検証します。