APIキーが使えない?401・402・403・429エラーの原因と対処法
AIのAPIキーが使えなくなる原因を解説。401・402・403・429の意味、残高切れのときに各プロバイダーが返すコード、それぞれの直し方をまとめました。
- AIのAPIキーが「使えない」ときは、エラー番号で原因が分かります。401はキー自体が間違っている、402はたいてい残高やクレジットの不足、403はその操作が許可されていない、429はリクエストが多すぎるか、プロバイダーによっては残高切れという意味です。
- 残高切れのときのコードは、プロバイダーによって違います。DeepSeek、OpenRouter、Mistral、Together、Fireworks、Geminiの前払い課金は402、OpenAI、Kimi、Z.aiは429、Alibaba CloudのQwenは403です。番号だけでなく、メッセージも読んでください。
- 残高のエラーは待っても直りませんが、レート制限はたいてい待てば解除されます。各プロバイダーの公式エラーページは、下の表にまとめました(2026年11月18日に確認)。

「APIキーが使えない」とはどういうこと?
APIキーは、アプリがリクエストのたびに送る秘密のコードです。AIプロバイダーはこれを見て、あなたであることと、どのアカウントに課金するかを判断します。うまくいかないとき、プロバイダーはエラーを返します。HTTPステータスコードと呼ばれる3桁の数字と、短いメッセージです。
数字が問題の種類を、メッセージが詳しい内容を教えてくれます。Oriveoはよくあるエラーを「無効な APIキー」や「プロバイダーの利用枠を超えました」のような分かりやすい見出しにして表示します。それぞれの意味は、このページの後半で説明します。
早見表:401・402・403・429・5xx
まずはここから。表示された番号を探し、下の該当するセクションを読んでください。この早見表は、2026年11月18日時点のOpenAI、Anthropicなど各社のエラーページにもとづいています。
| コード | よくある意味 | 待てば直る? | 対処 |
|---|---|---|---|
| 401 | キーが間違っている:文字の欠け、余分な空白、削除済みのキー、別のプロバイダーや別リージョンのキー | いいえ | キーをコピーし直すか新しく作る。プロバイダーとリージョンも確認する |
| 402 | 支払いが必要:前払いの残高やクレジットが尽きたか、支払いに問題がある | いいえ | チャージするか、プロバイダーの請求ページで支払い方法を直す |
| 403 | キーは有効だが許可されていない:対応していない国や地域、そのモデルへのアクセス権がない、本人確認などの手続きが必要 | いいえ | 対応地域とキーの権限を確かめ、必要な確認手続きを済ませる |
| 404 | モデル名かアドレスが間違っている | いいえ | 別のモデルを選ぶか、アドレスを確認する |
| 429 | 短時間のリクエストが多すぎる。プロバイダーによっては残高切れや支出上限 | レート制限なら、多くの場合は直る | 待って再試行する。メッセージにquota、balance、credit、spend limitなどがあれば、チャージするか上限を引き上げる |
| 500〜504、529 | プロバイダー側の障害や過負荷 | たいていは直る | 時間をおいて再試行するか、モデルを切り替える |
「残高不足」「クォータ超過」と出るのはなぜ?
多くのプロバイダーでは、APIを使う前に前払いのクレジットか有効な支払い方法が必要で、残高が尽きたときの知らせ方は各社ばらばらです。どの場合も、新しいキーでは直らず、クレジットを追加すれば直ります。
以下は、Oriveoの15社の組み込みプロバイダーが、残高やクレジットが尽きたときに返すとドキュメントに記載しているコードです。「明記なし」は、2026年11月18日に確認した時点で、そのプロバイダーのドキュメントにこの場合のHTTPコードが書かれていないという意味です。
| プロバイダー | 残高が尽きたときのコード | メッセージの内容 | 公式ページ |
|---|---|---|---|
| OpenAI | 429 | credit_balance_exhausted(エラーの種類はinsufficient_quotaと表示されることもある) | developers.openai.com/api/docs/guides/error-codes |
| Anthropic(Claude) | 明記なし | 「Your credit balance is too low to access the Anthropic API」。支払いの問題では402 billing_errorを返す | platform.claude.com/docs/en/api/errors(コード)、platform.claude.com/docs/en/about-claude/api-credits-for-subscribers(メッセージ) |
| Google Gemini | 402(前払い課金) | payment_required。Cloud Billingに未払い残高がある場合も403になることがある | aistudio.google.com/docs/api-errors |
| OpenRouter | 402 | アカウントまたはAPIキーのクレジットが足りない | openrouter.ai/docs/api-reference/errors |
| DeepSeek | 402 | Insufficient Balance | api-docs.deepseek.com/quick_start/error_codes |
| xAI(Grok) | 明記なし | 前払いクレジットが尽きると、リクエストが拒否される | docs.x.ai/console/billing |
| Mistral AI | 402 | Payment required | docs.mistral.ai/resources/error-glossary |
| Groq | 記載なし | Groqは利用後の請求で、エラーページに残高のエラーは載っていない | console.groq.com/docs/errors |
| Together AI | 402 | Payment Required | docs.together.ai/docs/error-codes |
| Fireworks AI | 402 | Payment Required | docs.fireworks.ai/guides/inference-error-codes |
| MiniMax | 明記なし(ビジネスコード1008) | insufficient balance | platform.minimax.io/docs/api-reference/errorcode |
| Z.ai(GLM) | 429(コード1113) | Insufficient balance or no resource package. Please recharge. | docs.z.ai/api-reference/api-code |
| Qwen(Alibaba Cloud) | 403 | Arrearageまたはisv.OUT_OF_SERVICE(アカウントが未払いの状態) | alibabacloud.com/help/en/model-studio/error-code |
| Kimi(Moonshot AI) | 429 | exceeded_current_quota_error | platform.kimi.ai/docs/api/errors |
| SiliconFlow | 記載なし | 残高のエラーは載っていない | docs.siliconflow.com/en/faqs/error-code |
401:APIキーが無効・認証に失敗した
401は、プロバイダーがキーを認識できないという意味です。よくあるメッセージは「Incorrect API key provided」(OpenAI)、「authentication_error」(Anthropic)、「Authentication Fails」(DeepSeek)、「Invalid API key: this is not an OpenRouter API key」(OpenRouter)です。
- プロバイダーのサイトからキーをコピーし直し、文字が欠けていないか、前後に空白が入っていないかを確認します。
- キーが、選んだプロバイダーのものか確認します。OpenAIのキーはOpenRouterのキーとしては使えず、その逆も同じです。
- Kimi、MiniMax、Qwenはリージョンごとに別々のプラットフォームを運営していて、あるリージョンのキーは別のリージョンでは使えません。Oriveoでは「公式 endpoint」(iPhoneでは「公式リクエスト URL」)の選択欄で、キーに合ったリージョンを選んでください。
- キーが削除・無効化された、または期限切れになった場合は、新しいキーを作ります。
402:支払いが必要・残高不足
402はお金の問題です。前払いの残高が空になったか、支払い方法でエラーが起きています。プロバイダーの請求ページでチャージするか支払い情報を更新してから、送り直してください。待っても直りません。
Oriveoでは「プロバイダーの利用枠を超えました」と表示され、「この API キーの利用枠または残高を使い切ったとプロバイダーが報告しています。プロバイダーの管理画面で請求情報を確認するか、モデルを切り替えてください。」と説明されます。
403:アクセス拒否・権限がない
403は、プロバイダーがキーを認識したうえで、リクエストを許可しないという意味です。理由はプロバイダーによって異なります。
- OpenAIは、対応していない国からAPIを使うと「Country, region, or territory not supported」を返します。対応している国の一覧は、各プロバイダーが公開しています。
- Geminiは、無料枠のプロジェクトで確認が必要なとき(FREE_TIER_VERIFICATION_REQUIRED)、紐づいたCloud Billingアカウントに未払いがあるとき、漏えいが報告されたキーをGoogleがブロックしたときに403を返します。
- Anthropicは、キーがそのリソースを使えないときにpermission_errorを返します。組織とワークスペースの設定を確認してください。
- OpenRouterは、権限、モデレーション、ガードレール、予算上限のいずれかでリクエストがブロックされると403を返します。
- SiliconFlowでは、一部のモデルに本人確認が必要です。
- Qwenは、アカウントが未払いのときと、無料枠を使い切ったうえで「Free Quota Only」の設定がオンになっているとき(AllocationQuota.FreeTierOnly)に403を返します。
429:リクエスト過多・レート制限・クォータ超過
429はたいてい、短時間にリクエストやトークンを送りすぎたという意味です。これはレート制限で、数十秒待てば解除されます。応答にRetry-Afterの時間が含まれていれば、その時間だけ待ってください。
ただし、残高切れや支出上限にも429を使うプロバイダーがいくつかあり、こちらは待っても直りません。OpenAI(credit_balance_exhausted、または自分で設定した支出上限)、Kimi(exceeded_current_quota_error)、Z.ai(コード1113)、そして組織が月の支出上限に達したときのAnthropic(enforced_spend_limit_reached)です。Anthropicの場合は、上位のティアを申請しない限り翌月まで続きます。
無料枠では制限がさらに厳しくなります。Geminiの無料枠とOpenRouterの無料モデルには、1分あたりと1日あたりの上限があります。
Oriveoでは、レート制限はWebで「レート制限」、iPhoneとAndroidで「プロバイダーのレート制限」と表示されます。メッセージがクォータやクレジットに触れている場合は、代わりに「プロバイダーの利用枠を超えました」と表示されます。
Oriveoのエラーメッセージの意味
Oriveoで表示される可能性のあるメッセージを、日本語版の表示どおりに載せています。
| Oriveoの表示 | 意味 | 対処 |
|---|---|---|
| 保存しましたが、キーが無効のようです。後でプロバイダー設定で確認できます。 | Oriveoにプロバイダーは保存されたが、確認の段階でプロバイダー側がキーを受け付けなかった | キーをコピーし直し、そのプロバイダーの設定で更新する |
| 無効な APIキー(Webでは「API Key が無効です」) | プロバイダーが401または403を返した | キーを確認するか差し替える。403ならリージョンと権限も確認する |
| プロバイダーの利用枠を超えました | このキーのクレジットや利用枠が尽きたとプロバイダーが伝えている(402、またはクォータに触れた429) | プロバイダーでチャージするか、別のモデルに切り替える |
| レート制限(Web)/プロバイダーのレート制限(iPhone・Android) | いまはリクエストが多すぎる(429) | 少し待ってから再試行する |
| 無料枠を使い切りました(Androidでは「無料利用枠の上限に到達」) | 今日のOriveo Freeの利用枠を使い切った。自分のキーとは関係ない | 自分のAPIキーを追加するか、UTC 0:00のリセットを待つ |

カスタムエンドポイント・中継サービス・ゲートウェイを使っている場合
カスタムエンドポイント経由で接続している場合、エラーの原因はそのサービス自体のこともあれば、その先のプロバイダーのこともあります。Oriveoが「この接続から上流のプロバイダーにつながりませんでした。」と表示した場合は、そのサービスがプロバイダーに持っているアカウントが無効、クレジット不足、またはレート制限中の可能性があります。あなたの設定の問題ではないので、別の接続に切り替えるか、サービスの運営者に問い合わせてください。
新しいキーを作る前に確認したいこと
新しいキーで直るのは401くらいです。まずは次の点を確認してください。
- 正しいプロバイダーを選んでいるか。Kimi、MiniMax、Qwen、SiliconFlow、Z.aiでは、リージョンも合っているか。
- 空白を含めず、キー全体をコピーしたか。
- アカウントにクレジットがあるか、有効な支払い方法が登録されているか。
- 自分の国や地域が、プロバイダーの対応リストに入っているか。
- 選んだモデルが、自分のアカウントやティアで使えるものか。