よくあるエラー

各ツールのガイドには、そのツール固有のエラーだけを記載しています。ここに挙げるものは、どのツールでも起こりえます。まずエラー内のステータスコードやキーワードを確認し、次の表で調べてください。

エラー	原因	解決方法
401 / invalid api key	キーが不完全、前後に空白がある、または伏せ字の表示値をコピーしている	API キー を開き、コピーアイコンをクリックして完全な HiAPI API キー をもう一度コピーする
エラーに残高、クォータ、利用上限のいずれかが含まれる	アカウントの残高が不足している、またはこのキーの利用上限を使い切っている	アカウント残高 でチャージするか、API キーページでこのキーの利用上限を引き上げる
403	このキーにはそのモデルに対する権限がない	キーのグループと権限を確認する。詳しくは 認証 を参照
404 / model not available	Base URL に /v1 が余分にある、または足りない。あるいはモデル名の綴りが違う	Base URL とプロトコル と照らし合わせて URL を確認し、テキストモデル一覧 からモデル名をコピーする
400 does not support this endpoint	ツールで選択したプロトコルに、このモデルが対応していない	別のプロトコルを試す（たとえば Claude なら Anthropic Messages を使う）か、別のモデルに切り替える
400 stream must be true / ずっと読み込み中のまま	このモデルはストリーミング専用なのに、ツールが非ストリーミングでリクエストを送っている	ツールのストリーミングをオンにする。ツールの「Check」や「Test connection」ボタンでこのエラーが出る場合は無視し、実際のチャットで判断する
429	リクエストや同時実行が多すぎる	少し待って再試行し、同時に走らせるタスクを減らす。クォータに関するエラーなら、上の「残高、クォータ」の行に従う
500 / 502 / 503	モデルサービスが一時的に失敗している	1 分か 2 分ほど待ってから再試行する。繰り返す場合は、まず別のモデルを試し、それでもだめならお問い合わせください
タイムアウト / 応答が途切れる	ネットワークやプロキシが長時間接続を遮断している	api.hiapi.ai に対するネットワークとプロキシのルールを確認してから、再試行する

再試行する前にリクエストログを確認する

エージェントのタスクは、サーバー側ではすでに完了していて、ツール側の接続だけが切れている場合があります。再試行する前に リクエストログ を確認し、このリクエストが成功したかどうか、いくらかかったかを確かめてください。同じ作業に二重に支払うのを避けられます。

それでも解決しない場合

お問い合わせ から、以下の情報を添えてチケットを送ってください。問題の特定が早くなります。

• エラーが発生した時刻（分単位まで）
• 使用したツールとバージョン（例：Claude Code 2.1.284）
• モデル名と Base URL
• エラーメッセージの原文、またはスクリーンショット

スクリーンショットを撮る前に API キーを伏せてください。また、サポートを含め、誰にもキーを送らないでください。