APIキーのトラブル解決

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日に確認)。
iPhone版Oriveoのプロバイダー画面。接続済みのプロバイダーと今月の利用額が並びます。

「APIキーが使えない」とはどういうこと?

APIキーは、アプリがリクエストのたびに送る秘密のコードです。AIプロバイダーはこれを見て、あなたであることと、どのアカウントに課金するかを判断します。うまくいかないとき、プロバイダーはエラーを返します。HTTPステータスコードと呼ばれる3桁の数字と、短いメッセージです。

数字が問題の種類を、メッセージが詳しい内容を教えてくれます。Oriveoはよくあるエラーを「無効な APIキー」や「プロバイダーの利用枠を超えました」のような分かりやすい見出しにして表示します。それぞれの意味は、このページの後半で説明します。

早見表:401・402・403・429・5xx

まずはここから。表示された番号を探し、下の該当するセクションを読んでください。この早見表は、2026年11月18日時点のOpenAI、Anthropicなど各社のエラーページにもとづいています。

早見表:401・402・403・429・5xx
コードよくある意味待てば直る?対処
401キーが間違っている:文字の欠け、余分な空白、削除済みのキー、別のプロバイダーや別リージョンのキーいいえキーをコピーし直すか新しく作る。プロバイダーとリージョンも確認する
402支払いが必要:前払いの残高やクレジットが尽きたか、支払いに問題があるいいえチャージするか、プロバイダーの請求ページで支払い方法を直す
403キーは有効だが許可されていない:対応していない国や地域、そのモデルへのアクセス権がない、本人確認などの手続きが必要いいえ対応地域とキーの権限を確かめ、必要な確認手続きを済ませる
404モデル名かアドレスが間違っているいいえ別のモデルを選ぶか、アドレスを確認する
429短時間のリクエストが多すぎる。プロバイダーによっては残高切れや支出上限レート制限なら、多くの場合は直る待って再試行する。メッセージにquota、balance、credit、spend limitなどがあれば、チャージするか上限を引き上げる
500〜504、529プロバイダー側の障害や過負荷たいていは直る時間をおいて再試行するか、モデルを切り替える

「残高不足」「クォータ超過」と出るのはなぜ?

多くのプロバイダーでは、APIを使う前に前払いのクレジットか有効な支払い方法が必要で、残高が尽きたときの知らせ方は各社ばらばらです。どの場合も、新しいキーでは直らず、クレジットを追加すれば直ります。

以下は、Oriveoの15社の組み込みプロバイダーが、残高やクレジットが尽きたときに返すとドキュメントに記載しているコードです。「明記なし」は、2026年11月18日に確認した時点で、そのプロバイダーのドキュメントにこの場合のHTTPコードが書かれていないという意味です。

「残高不足」「クォータ超過」と出るのはなぜ?
プロバイダー残高が尽きたときのコードメッセージの内容公式ページ
OpenAI429credit_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 Gemini402(前払い課金)payment_required。Cloud Billingに未払い残高がある場合も403になることがあるaistudio.google.com/docs/api-errors
OpenRouter402アカウントまたはAPIキーのクレジットが足りないopenrouter.ai/docs/api-reference/errors
DeepSeek402Insufficient Balanceapi-docs.deepseek.com/quick_start/error_codes
xAI(Grok)明記なし前払いクレジットが尽きると、リクエストが拒否されるdocs.x.ai/console/billing
Mistral AI402Payment requireddocs.mistral.ai/resources/error-glossary
Groq記載なしGroqは利用後の請求で、エラーページに残高のエラーは載っていないconsole.groq.com/docs/errors
Together AI402Payment Requireddocs.together.ai/docs/error-codes
Fireworks AI402Payment Requireddocs.fireworks.ai/guides/inference-error-codes
MiniMax明記なし(ビジネスコード1008)insufficient balanceplatform.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)403Arrearageまたはisv.OUT_OF_SERVICE(アカウントが未払いの状態)alibabacloud.com/help/en/model-studio/error-code
Kimi(Moonshot AI)429exceeded_current_quota_errorplatform.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の表示意味対処
保存しましたが、キーが無効のようです。後でプロバイダー設定で確認できます。Oriveoにプロバイダーは保存されたが、確認の段階でプロバイダー側がキーを受け付けなかったキーをコピーし直し、そのプロバイダーの設定で更新する
無効な APIキー(Webでは「API Key が無効です」)プロバイダーが401または403を返したキーを確認するか差し替える。403ならリージョンと権限も確認する
プロバイダーの利用枠を超えましたこのキーのクレジットや利用枠が尽きたとプロバイダーが伝えている(402、またはクォータに触れた429)プロバイダーでチャージするか、別のモデルに切り替える
レート制限(Web)/プロバイダーのレート制限(iPhone・Android)いまはリクエストが多すぎる(429)少し待ってから再試行する
無料枠を使い切りました(Androidでは「無料利用枠の上限に到達」)今日のOriveo Freeの利用枠を使い切った。自分のキーとは関係ない自分のAPIキーを追加するか、UTC 0:00のリセットを待つ
Oriveoのプロバイダー画面。OpenAI、Z.ai、Groq、Gemini、Anthropicなど接続済みのプロバイダーが支出額とともに並んでいる
この一覧からプロバイダーを開くと、キーを確認したり差し替えたりできます。

カスタムエンドポイント・中継サービス・ゲートウェイを使っている場合

カスタムエンドポイント経由で接続している場合、エラーの原因はそのサービス自体のこともあれば、その先のプロバイダーのこともあります。Oriveoが「この接続から上流のプロバイダーにつながりませんでした。」と表示した場合は、そのサービスがプロバイダーに持っているアカウントが無効、クレジット不足、またはレート制限中の可能性があります。あなたの設定の問題ではないので、別の接続に切り替えるか、サービスの運営者に問い合わせてください。

新しいキーを作る前に確認したいこと

新しいキーで直るのは401くらいです。まずは次の点を確認してください。

  • 正しいプロバイダーを選んでいるか。Kimi、MiniMax、Qwen、SiliconFlow、Z.aiでは、リージョンも合っているか。
  • 空白を含めず、キー全体をコピーしたか。
  • アカウントにクレジットがあるか、有効な支払い方法が登録されているか。
  • 自分の国や地域が、プロバイダーの対応リストに入っているか。
  • 選んだモデルが、自分のアカウントやティアで使えるものか。

アプリについてのよくある質問

APIキーが使えないのはなぜ?
エラー番号を見てください。401はキーが間違っている、402は残高やクレジット切れ、403はリクエストが許可されていない(多くは地域か権限の問題)、429はリクエストが多すぎるか、プロバイダーによっては残高切れです。
APIキーの401エラーとは?
プロバイダーがキーを認識できないという意味です。空白が入らないようにコピーし直し、選んだプロバイダーとリージョンのキーかを確認するか、新しいキーを作ってください。
402 Payment Requiredエラーとは?
前払いの残高やクレジットが尽きたか、支払いに問題があるという意味です。DeepSeek、OpenRouter、Mistral、Together、Fireworks、Geminiの前払い課金がこのコードを使います。プロバイダーの請求ページでチャージしてください。待っても直りません。
429エラーはレート制限?それとも残高不足?
どちらもあり得ます。たいていは、少し待てば解除されるレート制限です。ただしOpenAI、Kimi、Z.aiは残高が空のときも429を返すので、メッセージにquota、balance、creditといった言葉があれば、待たずにクレジットを追加してください。
OpenAIのAPIキーでinsufficient_quotaと出るのはなぜ?
OpenAIのAPIアカウントに前払いクレジットが残っていないためです。OpenAIはcredit_balance_exhaustedというコードで429を返し、エラーの種類はinsufficient_quotaのままのこともあります。OpenAIの請求設定でクレジットを追加してください。新しいキーでは直りません。
正しくコピーしたのに、新しいAPIキーが使えないのはなぜ?
多くの場合、アカウントにまだクレジットがないか支払い設定が済んでいない、キーが別のリージョンのものである、またはその国でAPIが提供されていない、のいずれかです。別のキーを作る前に、これらを確認してください。

関連記事

ブログの記事

どのキーのエラーも、分かりやすい言葉で

Web版を開くか、iPhone・Android版のOriveoをダウンロードして、15社のキーを追加しましょう。リクエストが失敗したときは、その理由がはっきり表示されます。

APIキーがまだなくても、Oriveo Freeで始められます。