API エラーコード一覧：401・403・429・5xx の対処法

88API の 401・403・404・429・5xx エラーの意味と対処法。無効なトークン、残高不足、レート制限、Claude Code のエラーも解説。

呼び出しに失敗すると、API は HTTP ステータスコードと JSON を返します。エラーの原因は error.message に記載されます：

{
  "error": {
    "code": "",
    "message": "Invalid token (request id: 2026101605444223...)",
    "type": "new_api_error"
  }
}

message の末尾にある request id はこのリクエストの番号です。サポートに問い合わせる際は一緒に伝えてください。コンソールの「利用ログ」ページにも、失敗したリクエストの時刻、モデル、エラー情報が記録されます。調査の際は、まずステータスコードを確認し、次に message を確認してください。

エラーメッセージは個人設定で保存した言語（またはクライアントの Accept-Language ヘッダー）に従います。どちらもない場合は中国語で返ることがありますが、意味は下記と同じです。

早見表

ステータスコード	意味	まずやること
400	リクエスト内容またはパラメータがモデルに受け付けられない	エラー内容に従ってパラメータ、プロンプト、画像を修正する
401	トークンが無効	API キーが正しく入力されているか、削除されていないかを確認する
403	トークンが利用不可、残高不足、または権限がない	残高、トークンの状態、トークンのグループとモデル制限を確認する
404	アドレスまたはモデルが存在しない	API アドレスに余分な `/v1` が付いていないか、モデル名が現在のグループで利用できるかを確認する
429	リクエストが多すぎる、またはモデルが混雑している	頻度を下げ、しばらくしてから再試行する
500、502、503、504、524	モデルサービスが一時的に利用できない、またはタイムアウト	しばらくしてから再試行する。失敗が続く場合はグループまたはモデルを変更する

401：トークンが無効

よくあるメッセージ：Invalid token、无效的令牌（無効なトークン）。

API キーのコピーが不完全、または前後にスペースや改行が入っている。
トークンがコンソールで削除されている。API トークンページで作成し直すか、コピーし直してください。
Claude Code：古い ANTHROPIC_API_KEY も設定されている。これは ANTHROPIC_AUTH_TOKEN より優先されるため、削除して ANTHROPIC_AUTH_TOKEN だけを残してください。
リクエストヘッダーの書き方：OpenAI 形式は Authorization: Bearer sk-...、Anthropic 形式は x-api-key: sk-... を使います。

403：トークンが利用不可、残高不足、または権限がない

残高または利用枠の不足

よくあるメッセージ：Insufficient user quota、Not enough quota to pre-consume for this request: … remaining, … required。

アカウント残高が今回のリクエストの事前引き落とし額に足りません。ウォレットでチャージしてください。
アカウントに残高があるのに不足と表示される場合：トークンには個別に利用枠の上限を設定できるため、そのトークンの残り利用枠を確認してください。
Claude Code では、この種の 403 が「認証失敗」や「API Error 403」と表示されます。対処法は同じです。

トークンの状態が利用不可

よくあるメッセージ：This token status is unavailable。

トークンが無効化されている、期限切れ、またはトークンの利用枠を使い切っています。API トークンページでトークンを有効化する、有効期限を変更する、または利用枠を調整してください。

グループまたはモデルの権限がない

よくあるメッセージ：No permission to access group …、API Key 所属专属分组不再允许当前用户使用（この API キーが属する専用グループは、現在のユーザーには利用できなくなりました）、This token has no access to model …。

トークンに紐づくグループを現在のアカウントで使えない：トークンを編集し、モデル広場で利用できるグループに変更してください。
トークンにモデル制限が設定されている：トークン設定で該当モデルを許可するか、別のトークンを使ってください。

現在のグループがこのエンドポイントに対応していない

よくあるメッセージ：This group does not allow /v1/messages dispatch。

選択したグループがこのプロトコルのエンドポイントに対応していません（例：OpenAI 形式のみ対応のグループで Anthropic の /v1/messages を呼び出した）。Claude Code では Claude グループのトークンを使ってください。その他のクライアントは、モデル広場に表示されているそのモデルの対応エンドポイント形式で呼び出してください。

404：アドレスまたはモデルが存在しない

アドレスの /v1 が多い、または足りない

よくあるメッセージ：Invalid URL、404 page not found。

Claude Code の ANTHROPIC_BASE_URL には https://api.88api.ai を設定し、/v1 は付けないでください（Claude Code は自分で /v1/messages を付け足すため、.../v1 と書くと /v1/v1/messages になります）。
Codex の base_url には https://api.88api.ai/v1 を設定し、/v1 を必ず付けてください。
ほとんどの OpenAI 互換アプリでは https://api.88api.ai/v1 を入力します。各アプリの設定方法はアプリ接続ガイドを参照してください。

モデルが現在のグループで利用できない

よくあるメッセージ：No available channel for model … under group …、Model "…" is not supported by any configured account in this group、model not found。

モデル名の誤記、または余分な接頭辞・接尾辞が付いている。個人設定またはモデル広場から正確なモデル名をコピーしてください。
そのモデルがトークンで選択したグループに含まれていない。モデル広場でモデルが対応するグループを確認し、トークンのグループを変更してください。

400：リクエスト内容またはパラメータが受け付けられない

エラーメッセージ（例）	原因と対処
`输入内容超过模型上下文限制`（入力がモデルのコンテキスト上限を超えています）、`Input exceeds the context limit`	会話が長すぎます。履歴を削るか新しいセッションを始めてください。Claude Code では `/compact` でコンテキストを圧縮できます
`请求中包含该模型不支持的参数（如 presence_penalty / frequency_penalty）`（このモデルが対応していないパラメータが含まれています。例：presence_penalty / frequency_penalty）	エラーに記載されたパラメータを削除してください
`该模型是生图模型，不能通过对话接口调用`（このモデルは画像生成モデルのため、チャット API では呼び出せません）	画像生成は `/v1/images/generations`、画像編集は `/v1/images/edits` を使ってください。画像 API を参照
`please use the Gemini native API`	このモデルは Gemini ネイティブ形式のみ対応しています。Gemini API を参照
`the selected model cannot disable reasoning`、`不支持关闭深度思考`（思考モードの無効化には対応していません）	このモデルは思考を有効にする必要があります。思考を無効にするパラメータを削除してください（または思考タイプを enabled にしてください）
`requires adaptive thinking`	この Claude モデルはアダプティブ思考が必要です。`thinking` パラメータを削除するか、エラーの指示どおり `type=adaptive` に変更してください
`当前输入触发平台内容安全规则`（入力がプラットフォームのコンテンツ安全ルールに抵触しました）、`未通过内容安全审核`（コンテンツ安全審査を通過しませんでした）、`可能违反了…内容政策`（…のコンテンツポリシーに違反している可能性があります）	プロンプトまたは参照画像が安全審査でブロックされました。内容を修正して再試行してください
`Failed to download multimodal content`、`mime type is not supported`	画像 URL にアクセスできない、または形式が対応していません。インターネットからアクセスできる PNG、JPEG、WebP 画像に変更するか、base64 で送信してください

429：リクエストが多すぎる、または混雑

アカウントのリクエスト頻度の上限超過

よくあるメッセージ：Your request rate is too high. The current user group allows up to … successful requests within a …-minute window。

デフォルトの上限は 60 RPM（1 分あたりのリクエスト数）です。同時実行数を下げるか、クライアント側で再試行の間隔を空けてください。より高い頻度がどうしても必要な場合は、カスタマーサポートに引き上げを申請してください。

モデルが混雑している

よくあるメッセージ：Upstream rate limit exceeded、service error, please try again later、Concurrency limit exceeded。

モデルへのリクエストが集中しています。数秒待ってから再試行してください。安定性が必要な場合は、モデル広場で別のグループに変更できます。

500、502、503、504、524：サービスが一時的に利用できない、またはタイムアウト

よくあるメッセージ：Upstream service temporarily unavailable、Service temporarily unavailable. Please retry.、系统过载，请稍后重试（システムが過負荷です。しばらくしてから再試行してください）、模型请求失败，请稍后重试或更换模型（モデルへのリクエストに失敗しました。しばらくしてから再試行するか、モデルを変更してください）、bad response status code 504。

この種のエラーは、モデルサービスの一時的な混雑やネットワークの揺らぎによるものが多く、通常は再試行で回復します。クライアントでは 1 秒、2 秒、4 秒と間隔を徐々に広げて再試行することをおすすめします。
同じモデルで失敗が続く場合は、別のグループまたは別のモデルに変更してください。
524 と 504 は生成に時間がかかるリクエストで多く発生します。チャットリクエストではストリーミング出力（stream: true）を有効にしてください。画像生成や動画には非同期タスク API を使い、結果をポーリングしてください。

それでも解決しない場合

利用ログで失敗したレコードを見つけ、**リクエスト時刻、モデル名、ステータスコード、完全なエラーメッセージ（request id を含む）**をオンラインサポートに送ってください。API キー全体は送らないでください。

エラーコードとよくあるエラー

早見表