status_code=500, not implemented
エラーに status_code=500 と not implemented が含まれる場合は、まず選択モデルが現在の endpoint のプロトコルをサポートするか確認します。たとえば /v1/responses には supported_endpoint_types の openai-response が必要です。このタイプがない場合は、一時的な upstream 障害ではなくプロトコルの非互換です。
- 自作アプリは
supported_endpoint_typesに従って endpoint を選びます。openaiを含む場合は/v1/chat/completionsを使用します。 - Claude Code はClaude Code ガイドに従い、モデルが
anthropicに対応することを確認します。 - 対応する endpoint に切り替えてから再度テストしてください。待機やネットワーク変更では解決しません。
400 Bad Request／パラメーター非互換
400 は通常、リクエスト形式、パラメーター、またはセッション状態が endpoint の要件に合わないことを示します。- モデル ID をモデルマーケットプレイスから正確にコピーします。
- endpoint、モデル、クライアントの組み合わせを接続方法の概要で確認します。
- 画像、ツール呼び出し、推論、セッション継続のパラメーターがモデルでサポートされるか確認します。
- 古いクライアントや SDK を更新します。
- 新しいセッションで短いテキストを送信します。
401 Unauthorized
Key がない、誤っている、無効化／期限切れ、または認証ヘッダーの形式が正しくないことが主な原因です。403 Forbidden
403 はリクエストが拒否されたことを示します。選択グループの権限不足、モデル制限、IP 許可リスト不一致、アカウント状態、または upstream モデルサービスの拒否が原因になり得ます。 Key のグループ、モデル制限、IP 許可リストを確認してから短いテキストで試してください。続く場合は Request ID、モデル、時刻、エラー本文を提示します。高頻度の再試行や Key の作り直しではアクセス制限は解消しません。404 Not Found／リクエストアドレスの誤り
次を優先して確認します。- Base URL が
/v1/v1/...になっていないか。 - クライアントが
/v1または具体的なパスを自動追加していないか。 /v1/chat/completions、/v1/responses、/v1/messages、/v1/images/generationsのいずれかを用途に合わせているか。
503 / no available channel になることが多いです。
429 Too Many Requests
429 はプラットフォームのレート制限またはモデルサービスの一時制限で発生します。Concurrency limit exceeded for user は通常 upstream またはクライアント側の同時実行制限であり、ステータスコードだけで Key の問題とは判断できません。
- 同時実行数を下げ、
Retry-Afterがあれば優先します。なければランダムジッター付きの指数バックオフを使います。 - 同じ Key で複数プログラムが高頻度リトライしないようにします。
- 低頻度でも続く場合は Request ID を提示します。
500、502、503、504、524
先述のnot implemented を除き、これらは処理失敗、接続中断、混雑、待機タイムアウトを表すことが多く、Key やプロンプトの誤りとは限りません。
同じモデルで長いタスクが連続して失敗する場合は、追加の長いタスクを一度止め、情報を保存してサポートに連絡してください。
no available channel／現在このモデルに利用可能なサービスがない
現在の Key のグループに、そのモデルで利用できるサービスが一時的にない状態です。モデル ID の誤り、グループ未提供、モデルの一時的な利用不可、メンテナンスが考えられます。
後で試すか、モデルマーケットプレイスでそのグループに見える別モデルを使います。続く場合はモデル名、Request ID、時刻を提出してください。このメッセージは再チャージや Key の再作成とは関係ありません。
Concurrency limit exceeded for user
アカウントの同時実行リクエスト数が上限です。実行中のリクエストが終わるまで待ち、クライアントの並行数を下げます。このエラーだけで Key を無効化・再作成する必要はありません。
長い会話またはツール呼び出しのエラー
Invalid signature in thinking block
現在のセッションに保存された推論内容を検証できなくなりました。長いセッションの再開、クライアント状態変更、互換性変更で起きることがあります。新しいセッションを作成し、クライアントを更新し、複数端末で同じセッションを続けないでください。
previous_response_id is only supported on Responses WebSocket v2
クライアントが未対応の接続方式で以前の応答を継続しようとしています。新しいセッションを開始し、実験的なセッション継続／応答再利用をオフにするか、クライアントを更新してください。
Content block not found
長い会話、ツール呼び出し、ストリーム中断で、必要な完全なコンテンツ断片をクライアントが受け取れないことがあります。新しいセッションを作り、入力を短くして簡単なテストを行ってください。続く場合は必須でないツール呼び出しを一時的に無効にし、Request ID、発生時刻、モデル、元のエラーをサポートに送ってください。これらの情報をもとに、サービス状態を確認します。
画像生成のタイムアウトまたは機能未対応
画像モデルは画像 endpoint を使用し、テキストモデルを画像生成 endpoint に送ることはできません。画像生成は同期的で時間がかかる場合があります。同じ画像タスクを再送する前に、最初のリクエストの結果を確認してください。Image generation is not enabled/model not supported：モデル、endpoint、パラメーターを確認します。504/524/ クライアントタイムアウト：Request ID と時刻を保存してから、再生成が必要か判断してください。