これはバックオフでは解決できない429です。insufficient_quotaは、アカウントに使用可能なクレジットがないことを意味します。モデルが実行される前にリクエストが拒否され、請求状態が変わるまで拒否され続けます。現在の請求状態を確認し、数分で解消する方法を説明します。
エラー
{
"error": {
"message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes/api-errors.",
"type": "insufficient_quota",
"param": null,
"code": "insufficient_quota"
}
}原因と対処法の概要
| 原因 | 対処法 |
|---|---|
| 前払いクレジット残高は$0です | APIは前払い方式です。Settings → Billingでクレジットを購入するか、自動チャージを有効にしてください。カードを登録しただけでは、クレジットを購入するまで残高は追加されません。 |
| 無料トライアルのクレジットが期限切れ、または使い切られています | トライアル付与分は、未使用でも通常3か月後に期限切れになります。対処方法は同じで、支払い方法を追加してクレジットを購入してください。 |
| 月間予算上限に達しました | Limitsで自分で設定した予算に達すると、その月の残り期間はリクエストがブロックされます。上限を引き上げるか、月が切り替わるまで待ってください。 |
| キーが予算のないプロジェクトまたは組織に属しています | sk-proj-キーは所属プロジェクトの予算を使用します。プロジェクトには、組織より低い独自の上限を設定できます。組織全体の合計だけでなく、ダッシュボードでキーのプロジェクトを確認してください。 |
クォータではなくレート制限かどうかを確認する
error.typeを確認してください。rate_limit_exceededは1分以内に自然に解除されるため、バックオフが必要です。insufficient_quotaは自然に解除されないため、再試行しても無意味です。不明な場合は60秒後に1回だけ再試行すれば判定できます。同じメッセージで429が続く場合は、請求の問題です。
キーが実際に使用するクレジット残高を確認する
platform.openai.com → Settings → Billingでクレジット残高を確認します。0またはマイナスならクレジットを購入してください。次にSettings → Limitsで月間予算上限を確認し、さらにsk-proj-キーの場合は、所有プロジェクト独自の使用量上限も確認します。これら3つはいずれも独立してこのエラーを発生させる可能性があります。
インシデントだけでなく、再発を止める
適切なしきい値で自動チャージを有効にし、忙しい週末に本番環境が停止しないようにしてください。また、ハード上限だけでなく予算アラートも設定し、リクエストが失敗し始める前に上限への接近を把握できるようにします。
Kunavo経由で呼び出している場合
Kunavoも同じ前払いモデルを採用しているため、率直な比較は仕組みではなく、ウォレットの影響範囲について行うべきです。1つのKunavo残高でGPTとClaudeの両方を、トークン単位の料金で利用でき、失敗したリクエストには一切課金されません。Kunavo自体のウォレットが枯渇すると、コードinsufficient_quotaの402が返ります（OpenAI SDKのエラーハンドリングをそのまま使えるよう、意図的に同じコードにしています）。チャージすれば即座に解除され、月間上限もありません。 予算を見積もっていますか？現在のGPTのトークン単価と、OpenAI公式リストとの比較は GPT API料金一覧.
よくある質問
クレジットカードを追加したのに、なぜinsufficient_quotaが返り続けるのですか？
APIはカードを直接使うのではなく、前払いクレジットを使用するためです。カードの追加は購入を可能にするだけで、クレジットを購入するか、自動チャージを有効にする必要があります。残高がプラスになってから1〜2分以内にエラーは解消されます。
insufficient_quotaは自然に解消されますか？
月間予算上限の場合に限り、月が切り替わるとリセットされます。残高ゼロとトライアル期限切れの場合は、クレジットを購入するまで解消されません。いずれの場合も再試行ループは役に立ちません。モデルが実行される前にリクエストが拒否されるためです。
失敗した429リクエストに料金はかかりますか？
いいえ。OpenAIは推論前に拒否し、Kunavoでも失敗したリクエストには一切課金されません。発生するコストはダウンタイムです。そのため、ハード上限だけよりも、自動チャージと予算アラートの併用が有効です。