Gemini API を試そうと料金表を開くと、「Free of charge」と「Not available」が行ごとに入り混じっています。
どのモデルが無料なのか、一目では分かりません。
答えは、AI Studio で API キーを作れば無料枠で使い始められ、無料で呼べるモデルは料金表の「Free of charge」で見分けられるです。RPM・TPM・RPD の具体的な数字だけは、AI Studio の Rate Limit ページで見るのが確実です。
「PythonとGemini APIでYouTube自動要約する方法」の記事では、上限を「各コンソールで確認してください」としか書けませんでした。その宿題を、ここで片付けます。
無料枠と有料枠の違い、キーの取り方、残りの確かめ方、429 が出たときのリトライ、課金に進む前の上限設定まで、手元で動かしたコードと一緒に整理します。
この記事でわかること
- 無料枠で呼べるモデルの見分け方と、使えないモデルの例
- 無料枠と有料枠の違い(上限・モデル・データの扱い)
- RPM・TPM・RPD の意味と、数字を確かめる画面
- API キーの作り方と、漏らさないための置き方
- 429 エラーの種類と、リトライ・バックオフのコード(実行結果つき)
- 有料に切り替える前に入れておく支出の上限
PARTS LIST /目次
Gemini API の無料枠でできること
Gemini API の無料枠とは、Google が Gemini API に用意している課金のない利用区分(Free tier)です。対象のモデルを、上限つきで料金なしに呼び出せます。
小さな自動化や試作には足りる一方、本番運用を想定した区分ではありません。料金ページには、無料は「小規模な試用向け」、有料は「本番運用向け」という位置づけで並んでいます。
境目になるのは、使えるモデルの範囲、上限の高さ、そして送ったデータの扱いの3点です。順に見ていきます。
無料で使えるモデルは料金表の「Free of charge」で見分ける
どのモデルが無料かは、料金ページのモデルごとの表に書かれています。「Free tier」の欄が「Free of charge」なら無料枠で呼べて、「Not available」なら有料枠でしか使えません。
代表的なモデルの一部です(単価は有料枠に進んだときの Standard、100万トークンあたり)。
画像を生成する Nano Banana 系や、Genie 4、Omni 系も、無料枠の欄は「Not available」です。
単価は改定が予告されているモデルがあります。たとえば Gemini 3.8 Flash は、上の単価が2026年12月31日までで、2027年1月1日からは入力 $1.50・出力 $7.50 に上がります。Gemini 4 Carbon も2026年12月1日から入力 $4.00・出力 $20.00 です。
表を写して終わりにせず、使う前に料金ページの該当行を見てください。この記事では「どの行を見るか」を伝えるところまでにとどめます。
2.5 系は2026年12月1日に別のモデルへ転送される
古いモデルを指定したコードは、気づかないうちに別のモデルに切り替わる日があります。モデル一覧のページには、次の転送予定が載っています。
gemini-2.5-flash-lite は非推奨になっておらず、廃止の時期は未定です。
転送されるのは「モデル名を文字列で書いたコード」です。出力の癖や速度、無料枠の上限が変わるので、モデル名は設定ファイルの1か所にまとめておくと、移行の日に直す場所が1つで済みます。
モデル名は、一覧ページで「Stable」と表示されているものを選ぶと安全です。プレビュー版はレート制限が厳しく、廃止の通知も少なくとも2週間前という扱いです。
無料枠と有料枠の違いは上限・モデル・データの扱い
無料と有料の差は、金額だけではありません。使えるモデルの幅、上限の高さ、送ったデータが何に使われるかまで変わります。
特にデータの扱いは、あとから「無料だから」と気軽に使った入力が引っかかる部分です。料金ページと利用規約のページから、違いを並べます。
無料枠の入出力は製品改善に使われる
無料枠(規約では Unpaid Services)に送ったプロンプトと回答は、Google の製品やサービス、機械学習技術の提供・改善・開発に使われます。担当者が内容を読んだり注釈を付けたりすることもあります。その場合、閲覧の前にアカウントや API キー、クラウドプロジェクトとの紐づけは切り離されます。
有料枠(Paid Services)では、入出力は製品の改善には使われません。ただしログは、禁止利用ポリシーの違反の検出、安全性とセキュリティの維持、法的な開示のために、限られた期間だけ保持されます。
有料枠に当たるのは、有効な課金アカウントに紐づくプロジェクト経由の利用です。無料枠のプロジェクトを有料に切り替えると、そのプロジェクトのデータの扱いも有料側に変わります。
規約には、無料枠に機密情報・秘密情報・個人情報を送らないよう、はっきり書かれています。手元で試すつもりでログや問い合わせ文面をそのまま貼ると、製品改善に使われる側のデータに入ります。
実データで試したいときは、有料枠のプロジェクトを使うか、ダミーに置き換えてから送るのが安全です。
地域と年齢の条件にも注意する
規約には、使う人の条件も書かれています。18歳以上であること、そして18歳未満の人が使うかもしれないサービスの中では使えないことです。
EEA・スイス・英国では、API クライアントをユーザーに提供する場合は有料サービスだけが使えます。また、これらの地域では無料枠であっても、有料サービス向けのデータ利用条件が適用されます。
個人で自分のツールに組み込む分には引っかかりにくい条件ですが、アプリとして人に配る段階では確認が必要です。
RPM・TPM・RPD の仕組みと確認先
無料枠の「制限」は、3つの数字で決まります。それぞれが何を数えているのか、どの単位で効くのかを押さえておくと、429 が出たときの原因を切り分けられます。
では、その3つの数字は具体的にいくつなのか。ここに表を写したくなりますが、やめました。理由は最後の H3 で書きます。
3つの上限は、1つでも超えると止まる
レート制限のページでは、上限を次の3軸で測っています。
判定は「いずれか1つでも超えたらエラー」です。ページの例では、RPM が20なら、TPM に余裕があっても1分間に21件送った時点でエラーが返ります。
長い文章を1件ずつ送るスクリプトは TPM で止まりやすく、短い呼び出しを大量に回すスクリプトは RPM や RPD で止まります。どの軸に当たったのかで、直し方が変わります。
上限はプロジェクト単位で、RPD は太平洋時間でリセットされる
上限が効く単位は、API キーではなくプロジェクトです。同じプロジェクトでキーを何本作っても、枠は増えません。
RPD のリセットは、太平洋時間の深夜0時です。日本時間にすると、標準時の冬は17時、夏時間の期間は16時です。夕方に「今日の分が尽きた」と気づいたときは、数時間待てば戻る計算です。
モデルごとに上限が違い、プレビュー版や実験版は正式版より厳しくなります。Rate Limit ページでもモデルごとに行が分かれているので、使うモデルの行を見ます。
具体的な数字は AI Studio の画面で見る
数字を記事に写さない理由は、上限がモデルごと・Tier ごとに違い、アカウントの状況に応じて自動で更新されるからです。レート制限のページにも「記載された上限は保証されず、実際の処理能力は変動し得る」という趣旨の注記があります。
自分のプロジェクトに適用されている値は、AI Studio の Rate Limit ページで確認できます。現在の Tier は Projects ページで見られます。
つまり、この記事が書ける「確かな数字」は「どこを見ればいま有効な数字が分かるか」までです。その場所が分かれば、数字が変わっても同じ手順で追えます。
API キーの取り方と最初の1回
キー作りは、無料枠の入口です。数分で終わりますが、作ったキーの置き場所を間違えると、あとで一番高くつきます。
AI Studio でキーを作る
手順は API キーのページのとおりです。
step
1API Keys ページを開く
AI Studio の API Keys ページを開きます。キーは必ず Google Cloud のプロジェクトに紐づきます。プロジェクトは、請求・共同編集者・権限をまとめる単位です。
step
2プロジェクトを用意する
新規ユーザーは、利用規約に同意するとデフォルトのプロジェクトとキーが自動で作られます。既存の Google Cloud ユーザーは自動では作られないため、ダッシュボードの Projects から「Import projects」で取り込み、そのプロジェクトで「Create API key」を押します。
step
3権限エラーが出たら管理者に頼む
「Create API key」が使えず権限のメッセージが出る場合は、プロジェクトの管理者に Project Editor などの IAM 権限をもらいます。
2026年5月28日以降、AI Studio で作る新しいキーは、サービスアカウントに紐づく「認証キー(auth key)」に切り替わります。
環境変数に入れて、コードにもリポジトリにも書かない
クライアントライブラリは、環境変数 GEMINI_API_KEY または GOOGLE_API_KEY を自動で読みます。両方あるときは GOOGLE_API_KEY が優先されます。
# ~/.zshrc の末尾に追加して、source ~/.zshrc で反映する
export GEMINI_API_KEY="(自分のキー)"
キーはパスワードと同じ扱いです。漏れると、第三者に枠を使い切られたり、予期しない請求が出たりします。
- Git にコミットしない(
.envは.gitignoreに入れる) - Web やモバイルアプリのコードに埋め込まない(バックエンドを経由させる)
- 漏れたかもしれないときは、新しいキーを作って動作を確かめてから古いキーを無効にする
- Gemini API 専用に制限をかけておく(制限のない標準キーは Gemini API に拒否されるようになる)
最小の呼び出しは、クイックスタートに載っている形です。インストールは pip install -U google-genai、キーを環境変数に入れておけば、genai.Client() を引数なしで作れます。
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-4-hydrogen",
input="Explain how AI works in a few words"
)
print(interaction.output_text)
REST で呼ぶ場合は、キーを x-goog-api-key ヘッダで渡します。
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-H "Api-Revision: 2026-05-20" \
-d '{"model": "gemini-4-hydrogen", "input": "Explain how AI works in a few words"}'
残りの使用量は AI Studio の画面と 429 で確かめる
「あと何回呼べるか」を返す専用の画面や API は、公式のページでは案内されていません。確かめる道具は、画面での上限・使用量の確認と、制限に当たったときの 429 の2つです。
AI Studio で見る場所は3つ
見る場所は目的ごとに分かれています。
上限はモデルごとに行が分かれているので、使うモデルの行だけ見れば足ります。Tier が変わると上限も自動で更新されます。
429 は3種類のコードに分かれる
制限に当たると、HTTP 429 が返ります。エラーコードの一覧では、429 は次の3つに分かれています。
トラブルシューティングのページでは、同じ429 が RESOURCE_EXHAUSTED という名前で出てきます。有料枠の「10分あたりの消費額上限」に当たったときにも、この 429 RESOURCE_EXHAUSTED が返ります。
見分けのコツは、エラーの本文を捨てずにログへ残すことです。「数秒待てば直る 429」と「明日まで直らない 429」では、スクリプトの動きを変える必要があります。
429 以外の、よく出るコードも並べておきます。
無料枠が使えない状態の403では、同じプロジェクトでキーを作り直しても解決しません。必要なのは Cloud Billing の紐づけです。
キーの再発行を何度も試す前に、エラーの本文と Projects ページの状態を先に見ると遠回りしません。
制限に当たったときはリトライ・バックオフで待つ
429 や 503 は、スクリプトを書き直さなくても、少し待てば通る場合があります。ただし、待ち方を間違えると逆効果です。同じ瞬間に全員が再送すると、またぶつかります。
公式が勧める手順は、指数バックオフ(待ち時間を 1秒、2秒、4秒、8秒と倍にする)、ジッター(待ち時間に乱数を足す)、再試行回数の上限の3点です。
再試行してよいのは一時的なエラーだけ
何度やっても同じ結果になるエラーを再試行すると、時間と枠を無駄にします。判断の流れを図にします。
flowchart TD
A["API を呼ぶ"] --> B{"ステータス"}
B -->|"200"| C["結果を使う"]
B -->|"400 401 402 403"| D["原因を直す<br>再試行しない"]
B -->|"408 429 5xx"| E{"回数は上限未満か"}
E -->|"はい"| F["待って再試行<br>1 2 4 8秒 + 乱数"]
F --> A
E -->|"いいえ"| G["諦めて記録する"]
再試行の対象は、429・408・5xx に限ります。400 や 403 は、内容か設定を直さない限り何度送っても失敗します。
指数バックオフとジッターのコード
標準ライブラリだけで書いた関数です。SDK を使わず REST を直接呼ぶ場面を想定しています。待ち時間は min(60, 2 ** attempt) に 0〜1 秒の乱数を足し、最大でも約61秒にしています。
import json
import os
import random
import time
import urllib.error
import urllib.request
ENDPOINT = "https://generativelanguage.googleapis.com/v1beta/interactions"
# 再試行してよいのは一時的なエラーだけ(429・408・5xx)
RETRYABLE = {408, 429, 500, 502, 503, 504}
def call_gemini(prompt, model="gemini-3.5-flash-lite", max_retries=5,
endpoint=ENDPOINT, sleep=time.sleep):
"""Gemini API を呼び、一時的なエラーなら指数バックオフ+ジッターで再試行する。"""
body = json.dumps({"model": model, "input": prompt}).encode()
headers = {
"x-goog-api-key": os.environ.get("GEMINI_API_KEY", ""),
"Content-Type": "application/json",
"Api-Revision": "2026-05-20",
}
for attempt in range(max_retries + 1):
req = urllib.request.Request(endpoint, data=body, headers=headers)
try:
with urllib.request.urlopen(req, timeout=60) as res:
return json.load(res)
except urllib.error.HTTPError as e:
if e.code not in RETRYABLE or attempt == max_retries:
raise # 400・403 などは直さない限り何度やっても同じ
wait = min(60, 2 ** attempt) + random.uniform(0, 1) # 1, 2, 4, 8... 秒 + 乱数
print(f"HTTP {e.code} 試行{attempt + 1}回目 -> {wait:.2f}秒待つ")
sleep(wait)
sleep を引数にしているのは、動作確認のとき待ち時間を差し替えるためです。普段は time.sleep がそのまま使われます。
擬似サーバーで動きを確かめる
このコードは、Gemini に接続せず、手元の擬似サーバーで動かしました。サーバーが決めた順にエラーを返し、「回復する」「400 で止まる」「429 が続く」の3パターンを確かめています(Python 3.11 の標準ライブラリのみ)。
--- /recover
HTTP 429 試行1回目 -> 1.13秒待つ
HTTP 429 試行2回目 -> 2.85秒待つ
HTTP 503 試行3回目 -> 4.76秒待つ
成功: {'ok': True}
サーバーに届いた回数: 4
--- /bad-request
失敗: HTTPError HTTP Error 400: Bad Request
サーバーに届いた回数: 1
--- /exhausted
HTTP 429 試行1回目 -> 1.26秒待つ
HTTP 429 試行2回目 -> 2.50秒待つ
HTTP 429 試行3回目 -> 4.45秒待つ
HTTP 429 試行4回目 -> 8.65秒待つ
HTTP 429 試行5回目 -> 16.79秒待つ
失敗: HTTPError HTTP Error 429: Too Many Requests
サーバーに届いた回数: 6
読み取れるのは3点です。
- 429・429・503 のあとに成功する流れでは、待ち時間が 1.13 → 2.85 → 4.76 秒と伸び、4回目で成功した
- 400 は1回で止まった。再試行しても結果が変わらないエラーに、枠と時間を使わない
- 429 が続くケースは、上限の5回再試行で諦め、サーバーには計6回届いた。無限に粘らない
実際の Gemini API が何回目で通るかは、この出力からは分かりません。確かめたのは、コードの分岐と待ち時間の伸び方です。
当たる前に、間隔を空けて送る
再試行は「当たってから」の手当てです。RPM の数字が分かっているなら、当たらない間隔で送るほうが先に効きます。たとえば RPM が30なら、2秒に1回までに抑えれば、1分間の上限は超えません。
import time
class Throttle:
"""1分あたり rpm 回を超えないよう、呼び出しの間隔を空ける。"""
def __init__(self, rpm):
self.interval = 60 / rpm
self.next_time = 0.0
def wait(self):
now = time.monotonic()
if now < self.next_time:
time.sleep(self.next_time - now)
self.next_time = max(now, self.next_time) + self.interval
API を呼ぶ直前に wait() を挟むだけです。rpm=30 で4回呼んだときの実行結果です。
1回目の呼び出し: 開始から 0.0秒
2回目の呼び出し: 開始から 2.0秒
3回目の呼び出し: 開始から 4.0秒
4回目の呼び出し: 開始から 6.0秒
rpm には、Rate Limit ページで確かめた自分の値を入れます。この関数が守るのは RPM だけで、TPM と RPD は別に数える必要があります。1日の呼び出し回数が RPD を超えそうな処理は、1日の処理件数そのものを減らすしかありません。
SDK なら自動で再試行される
Python の公式 SDK を使うなら、自前のバックオフは基本的に要りません。SDK は 429 と 5xx を含む一時的なエラーに、約1秒の初期遅延・最大60秒の遅延で、最大4回まで自動で再試行します。
自前で書くのは、REST を直接呼ぶ場合と、SDK の4回では足りない長い待ちが必要な場合です。
RPD(1日の上限)に当たった429は、何度待っても直りません。再試行の上限で諦めて、日付が変わる時刻(日本時間の16時または17時)まで処理を止めるほうが、枠も時間も無駄にしません。
有料枠に進む前に課金の上限を決める
無料枠で足りなくなったとき、課金の設定は数分で終わります。ただし、設定したあとは使った分が請求に乗ります。止めるための仕組みを先に入れておくのが順序です。
有料に進んだときの料金を試算する
単価は100万トークンあたりなので、感覚がつかみにくい数字です。使うモデルの入力・出力の単価に、トークン数を掛けて見積もります。
たとえば Gemini 2.5 Flash-Lite(入力 $0.10・出力 $0.40)で、入力 2,000 トークン・出力 500 トークンの呼び出しを1,000回行う場合です。
出力の単価は入力の4倍なので、長い文章を生成させる処理ほど出力側が効いてきます。思考トークンも出力に含まれる点は、料金ページの出力欄に書かれています。
これは手計算の例で、実際の請求額ではありません。自分のスクリプトの入出力トークン数は、AI Studio の Usage で確かめた使用量から逆算します。
課金を設定して Tier 1 に上がる
課金のページの手順は次のとおりです。
step
1Set up billing を押す
AI Studio の API Keys ページか Projects ページで、対象プロジェクトの「Billing Tier」列にある「Set up billing」を押します。
step
2請求アカウントを選ぶ
初めてなら、国・利用規約・連絡先・支払い方法を入力します。既存の請求アカウントがあれば、その中から選べます。
step
3支払い方式を選ぶ
最低5ドル(同等の現地通貨)の事前購入(Prepay)か、後払い(Postpay)が案内されます。アカウントによっては自動で割り当てられます。
請求アカウントをプロジェクトに紐づけると Tier 1 へ上がります。Tier は、請求アカウントの累計支払いに応じて上がります。
Free から Tier 1 へは通常すぐに反映され、以降の昇格は10分以内に反映されます。
プロジェクトごとに月の支出上限を入れる
予期しない請求を防ぐ一番手前の仕組みは、AI Studio の Spend ページの「Monthly spend cap」です。「Edit spend cap」から、プロジェクト単位で月の上限額を決めます。プロジェクトのエディター・オーナー・管理者の権限が必要です。
注意が2つあります。
- この機能は実験的な扱いで、請求データの反映に最大約10分の遅れがあるため、上限を少し超える利用が起きることがある
- 請求アカウント全体の上限は Tier で自動的に決まり、到達すると、そのアカウントに紐づく全プロジェクトが翌月1日まで止まる
さらに、有料枠には「10分あたりの消費額」の上限もあります。Tier 1 は $10、Tier 2 と Tier 3 は $200 で、超えると 429 RESOURCE_EXHAUSTED が返ります。無料枠(Free)は対象外です。
予算アラートは止めてくれない
Google Cloud の Billing で作る予算は、通知のメールが主な役目です。アラートだけの予算は、利用や支出を自動で止めない、と明記されています。
予算のしきい値は、初期値が予算額の50%・90%・100%(実績ベース)です。通知を Pub/Sub につなげば、プロジェクトの課金を無効にする処理を自分で組むこともできます。ただしそれは自動の停止機能ではなく、利用者が仕組みを作る前提です。
私なら、spend cap で「止める」層と、予算アラートで「気づく」層の2つを両方入れます。止める仕組みの反映は少し遅れるので、通知が後ろで支えてくれると安心できます。
Prepay は残高が0になると全キーが止まる
事前購入(Prepay)を選ぶと、残高が0になった時点で、その請求アカウントに紐づく全プロジェクトのキーが同時に止まり、HTTP 402 が返ります。自動チャージ(auto-reload)を設定すれば防げて、月ごとのチャージ上限も入れられます。
購入したクレジットは12か月で失効し、原則として返金されません。使い切れる額から始めるのが無難です。
課金を止めて無料枠に戻す場合や、請求アカウントを付け替える場合は、Google Cloud コンソールで操作します。
よくある質問
Q1. Gemini API の無料枠は本当に無料ですか?
料金ページで「Free of charge」と書かれているモデルは、無料枠で使う限り料金がかかりません。「Not available」のモデルは有料枠でしか使えません。課金を設定したプロジェクトは有料枠として扱われ、使った分が請求に乗ります。
Q2. 無料枠の RPM・TPM・RPD はいくつですか?
モデルごと、Tier ごとに違い、アカウントの状況で自動更新されます。AI Studio の Rate Limit ページで、自分のプロジェクトに適用されている値を確認してください。
Q3. RPD は何時にリセットされますか?
太平洋時間の深夜0時です。日本時間では、標準時の冬は17時、夏時間の期間は16時です。
Q4. 無料枠に送った内容は学習に使われますか?
無料枠のプロンプトと回答は、製品の提供・改善・開発に使われ、担当者が読むこともあります。機密情報・個人情報は送らないよう、規約に書かれています。有料枠では製品改善には使われません。
Q5. 429 エラーが出たらどうすればいいですか?
数秒〜1分で直る429なら、指数バックオフとジッターで再試行します。1日の上限(quota_exceeded)なら、再試行しても直らないので、リセットの時刻まで処理を止めます。
Q6. API キーを複数作れば、上限を増やせますか?
増えません。上限はキー単位ではなくプロジェクト単位で適用されます。
Q7. 予算アラートを設定すれば、使いすぎを防げますか?
防げません。アラートだけの予算は通知するだけで、利用や支出を止めません。止めたいときは、AI Studio の Monthly spend cap を使います。
Q8. Python の公式 SDK は 429 を自動で再試行しますか?
します。429 と 5xx を含む一時的なエラーに、約1秒の初期遅延・最大60秒の遅延で、最大4回まで自動で再試行します。REST を直接呼ぶ場合は自前で実装します。
数字は動くので、写さずに「見る場所」だけ覚えておけば足ります。ついでに Spend ページの月の上限も入れておくと、有料に進む日が来ても慌てません。
続きを追う:X(@Tom_Java_Tech) / RSS
途中経過は、また書きます。

