よくある API エラー

エラー全文、Request ID、時刻、モデル、endpoint を先に保存してください。パラメーター、プロトコル、会話互換性の問題は、連続再試行では解決しません。

`status_code=500, not implemented`

Anthropic 型 Claude チャネルを /v1/responses で呼び出した場合、このエラーはプロトコル不一致です。一時的な上流障害ではありません。

コード	よくある原因	最初の対応
400	モデル、endpoint、パラメーター、会話状態が不正	プロトコル確認後、新しい会話で最小テスト。
401	Key の欠落、無効、期限切れ、無効化	Key と Bearer 形式を再確認。
403	グループ、制限、IP、アカウント、上流拒否	Key の設定とグループを確認。
404	パス誤りまたは `/v1` 重複	実際の URL を確認。
429	頻度・同時実行数の制限	同時実行を減らし `Retry-After` に従う。
500 / 502 / 503	一時的な処理・上流問題	10～30 秒待って一度だけ再試行。
504 / 524	待機タイムアウト	必要に応じてコンテキストや出力を短くし、Request ID を保存。

no available channel：Key のグループに、そのモデルの有効な経路がありません。正確な ID、グループ、マーケットプレイスを確認してください。
Concurrency limit exceeded for user：実行中のリクエストを待ち、クライアントの並列数を下げます。
Content block not found：長い会話、ツール呼び出し、ストリーム中断でよく発生します。Content block not foundを参照してください。
画像のエラー／タイムアウト：画像モデル、Images endpoint、パラメーターを確認し、同じ画像タスクをすぐに再送しないでください。

想定外の請求は同じ期間の Request ID とログで照合します。通常のリクエストをプラットフォームが自動再試行するとは限りません。