💸

Gemini APIの無料枠で初回リクエストにも関わらず429が返ってきた

に公開
API
Gemini
tech

何が起きたか

Gemini APIを無料枠（Free tier）で使おうとしたが、初回リクエストにもかかわらず 429 RESOURCE_EXHAUSTED が返ってきた。

429 You exceeded your current quota, please check your plan and billing details.

初回リクエストなのでいずれのレート制限に該当するはずもないのになぜ...

原因

Google AI Studioの対象プロジェクトにて
Google Cloud の請求先アカウントをプロジェクトに紐付けていたことが原因だった。

Gemini API には以下の4つのTierがある。

Tier 条件
Free 有効なプロジェクトまたは無料トライアル
Tier 1 有効な請求先アカウントを設定してリンクしている
Tier 2 $100 のお支払い + 最初のお支払いが完了してから 3 日
Tier 3 $1,000 のお支払い + 最初のお支払いが完了してから 30 日

Gemini API お支払いと階層について

請求先アカウントを設定した時点でプロジェクトは自動的に Tier 1 に昇格し、Tier 1以降は前払いによるクレジット残高が消費される。
無料枠で利用する前提で、支払い方法を登録していない請求先アカウントを一応紐づけてしまっていた。

クレジットを持っていない状態でリクエストする形となり、利用可能なクォータがゼロと判定され、初回リクエストから 429 が返される状態となっていた。

対処法

プロジェクトを作成し直す

  • 個人開発プロジェクト(本番デプロイ前)
  • 初回リクエストから通らない

という状態なのでプロジェクトを作り直すデメリットが少ないと判断し、作り直した。
他作業としては、APIキーの再作成と環境変数の更新するくらい。

まとめ

  • Gemini API はプロジェクトに請求先アカウントを紐付けた時点で無料枠からTier 1に昇格する
  • Tier 1以降は前払いのクレジット残高が必要となり、残高が無ければ初回リクエストから429が返る
  • 無料枠を使いたいなら請求先アカウントをプロジェクトに紐付けない

Discussion