Gemini Decisions APIを無料で使う方法

Gemini Decisions API は、今日から無料で利用できます。Google の gemini-decision-1 の無料枠では、入力は無料、出力トークンの課金はなし、プロジェクトあたり毎分 200 リクエスト、毎分 50,000 トークン、1 日 10,000 リクエストまで利用可能です。必要なのは AI Studio の API キーだけで、課金アカウントは不要です。ただし注意点として、無料枠では Google がコンテンツを自社製品の改善に使用する場合があります。

以下では、これらの制限が実際のワークロードで何を意味するのか、100 万トークンあたり $0.10 という有料価格の背後にあるトークン計算、その他の $0 のルート、そしてテストや CI を日次クォータから切り離す方法を解説します。すべてのクォータと価格は 2026 年 11 月 12 日時点で Google の公式ページから確認したものです。API は v1beta として提供されているため、予算計画の前に再確認してください。質問タイプ自体(noul、choice、score)については、Google の Decisions API ガイドを参照してください。

Gemini Decisions API の無料枠に含まれるもの

Gemini Decisions API の無料枠とは、Google の Gemini Developer API の無課金利用枠を gemini-decision-1 モデルに適用したものです。Google Cloud プロジェクトごとに、入力処理は無料、出力の課金はゼロ、レート制限は 200 RPM、50,000 TPM、10,000 RPD に固定され、課金設定は一切不要です。

Google の価格ページと レート制限ページの内容を並べて比較すると、次のようになります:

見出しの数字よりも重要な詳細が 3 つあります:

• 制限は API キーではなくプロジェクト単位です。1 つのプロジェクトで 5 つのキーを作成しても、クォータが 5 倍になるわけではありません。
• 日次上限は太平洋時間の深夜 0 時にリセットされます。太平洋時間の午後 11 時に開始したバッチジョブは、その日のクォータを 1 時間だけ使った後、深夜 0 時を過ぎると新しい 10,000 リクエストを得られます。
• 無料枠のデータは Google に利用される可能性があります。価格表では「当社製品の改善に使用」が無料枠では「あり」、有料では「なし」とされています。顧客の PII、契約書、医療画像などを無料のキーで送信しないでください。

無料の Gemini Decisions API キーの取得方法

約 5 分で無料での API 呼び出しを開始できます:

1. Google AI Studio にサインインし、Create API key をクリックします。新しいプロジェクトが無料枠で開始されます。
2. SDK 3.2 以降をインストールします:pip install -U google-genai または npm install @google/genai@latest。
3. キーを GEMINI_API_KEY としてエクスポートし、SDK が読み取れるようにします。
4. http_options={"api_version": "v1beta"} を指定して 1 件のリクエストを送信し、レスポンスの usage ブロックを確認します。

from google import genai

client = genai.Client(http_options={"api_version": "v1beta"})

result = client.decisions.create(
    model="gemini-decision-1",
    input="Order 8821 arrived with a cracked screen.",
    questions={
        "is_damaged": {"type": "noul", "instructions": "Did the item arrive damaged?"},
    },
)

print(result.answers["is_damaged"].noul)
print(result.usage.total_input_tokens)

記録すべきは usage.total_input_tokens の数値です。無料枠ではこれが 50,000 TPM を消費するものであり、有料では課金の対象となる唯一の項目です。

Google のその他の無料提供については、Gemini API 無料枠ガイドと Gemini を無料で使う方法を参照してください。

Gemini Decisions API の料金体系の仕組み

課金対象は入力トークンのみで、質問の数に関係なく共有入力はリクエストごとに 1 回だけカウントされます。各質問が追加するのは、その質問自身の指示トークンと評価基準トークンだけです。出力は常に 0 トークンです。モデルがテキストではなく確率を返すためです。

したがって、1 リクエストの計算式はシンプルです:

input tokens = shared input + sum(each question's instructions + criteria)
paid cost    = input tokens / 1,000,000 x $0.10

興味深いのは、これが無料枠に与える影響です。テキストの場合はリクエスト数(200 RPM、10,000 RPD)が先に上限に達するのが一般的です。画像、音声、長いドキュメントの場合は 50,000 TPM の制限が先に効きます。

コスト計算例:無料枠 vs 有料

以下の質問トークン数は概算です(短い質問で約 30 トークン)。画像と音声の数値は Google の メディア解像度テーブルに基づいており、現行の Gemini モデルでは画像は low で 280 トークン、high で 1,120 トークン、音声は秒あたり 25 トークンとされています。実際のリクエストを 1 回実行し、私の数値を自分の usage 値に置き換えてください。

10,000 枚の製品写真 × 16 の質問

たとえば、配送写真について破損、配置、ラベルの視認性、その他 13 項目をチェックするとします。

• low 解像度での 1 リクエスト:280(画像)+ 20(テキストコンテキスト)+ 16 × 30(質問)= 780 トークン
• 10,000 枚:10,000 × 780 = 780 万トークン
• 有料コスト:7.8 × $0.10 = $0.78
• high 解像度の場合:1 枚あたり 1,120 + 20 + 480 = 1,620 トークン、合計 1,620 万トークン、$1.62

無料枠では TPM が処理速度を決めます:50,000 ÷ 780 = 約 64 枚/分。10,000 枚すべての処理には約 2 時間 36 分かかり、ちょうど 1 日分の 10,000 リクエストを消費します。high では約 30 枚/分で 5.5 時間です。

次に、避けるべきミスです。16 項目のチェックを 16 個の別々のリクエストとして送ると、それぞれが画像を再送することになります:16 × 300 = 4,800 の画像+コンテキストトークンに同じ 480 の質問トークンを加え、1 枚あたり約 5,280 トークン。合計 5,280 万トークン(有料で $5.28)と 160,000 リクエスト、つまり無料枠クォータの 16 日分です。質問は 1 つのリクエストにまとめましょう。

10,000 件のサポートチケット × 3 のルーティング質問

• 1 リクエストあたり:250(チケットテキスト)+ 3 × 40(評価基準付き質問)= 370 トークン
• 10,000 件:370 万トークン、有料で $0.37
• 無料枠:50,000 ÷ 370 = 135 リクエスト/分で、200 RPM の上限内。1 日分の 10,000 リクエストで 10,000 件のチケットを処理できます。

長い PDF

コンテキストウィンドウは 262,144 トークンですが、無料の TPM は 50,000 なので、120,000 トークンの契約書 1 件だけで無料予算の 1 分分を超えてしまいます。TPM 上限を超える単一リクエストを無料枠がどう処理するかは Google のドキュメントに記載されていないため、まず 1 件テストしてください。長いドキュメントこそ、Tier 1(100 万 TPM)が価値を発揮するケースです。

Gemini Decision 1 を $0 で使うその他の方法

2026 年 11 月 12 日時点で確認した OpenRouter のモデルページでは、プロバイダは 1 つ(Google AI Studio)で、入力は 100 万トークンあたり $0.10、出力は無料、:free バリアントはありません。OpenRouter の Decisions エンドポイントで動作するため、チャット補完 SDK からは呼び出せません。

無料枠内で使い続ける方法

次の習慣を守れば、プロトタイプをできる限り長く $0 のまま維持できます:

1. すべての質問を 1 つのリクエストにまとめる。共有入力は 1 回だけ課金され、最大 1,000 の質問を 1 回の呼び出しに収められます。
2. メディア解像度を下げる。low は画像あたり high の 4 分の 1 のコストです。
3. 質問に必要なフィールドだけを送る。Google によると無関係なコンテンツは精度を下げるうえ、TPM も消費します。
4. RPM ではなく TPM を基準にスロットリングする。ワーカーのペースを、実測の 1 リクエストあたりトークン数で 50,000 を割った値に合わせます。
5. 回答は自分でキャッシュする。API にはコンテキストキャッシュがなく、繰り返しの入力も全額カウントされるため、入力+質問をハッシュ化して重複をスキップします。
6. 大規模な実行は太平洋時間の深夜 0 時以降に開始する。1 日分のクォータをフルに使えます。
7. テストと CI を実際の API から切り離す。プッシュのたびに API を呼ぶテストスイートでは、昼までに 10,000 リクエストを使い切る可能性があります。モックに置き換えましょう。

Apidog CLI でコーディングエージェントに Decisions API をモックさせる

ユニットテストに実機のモデルは必要ありません。必要なのは正しい形式です:answers マップ、0.01〜0.99 の noul、confidence、そして usage.total_output_tokens: 0。コーディングエージェントなら Apidog CLI でそのモックを構築でき、実際の Google API に触れるのはスモークテスト 1 件だけにできます。

まず一度だけセットアップします:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

そのうえで、Claude Code、Codex、Cursor に次の 1 つのプロンプトを渡します:

In Apidog project <id>, add the Gemini Decisions endpoint POST /v1beta/decisions
with a request body of model, input and questions. Create mock expectations that
return a damaged answer (noul 0.97) and an undamaged one (noul 0.04), each with
usage.total_output_tokens = 0. Add a test case that asserts the answers map,
confidence between 0 and 1 and zero output tokens. Run it against the mock
environment, then once against the real API with my free-tier key.

エージェントは各ペイロードスキーマを読み取って検証し、その後にのみ次のコマンドを実行します:

apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file decisions-endpoint.json
apidog endpoint create --project <id> --file decisions-endpoint.json

apidog cli-schema get mock-create
apidog cli-schema validate mock-create --file mock-damaged.json
apidog mock create --project <id> --file mock-damaged.json

apidog cli-schema get test-case-create
apidog test-case create --project <id> --file decisions-case.json
apidog run --test-case <caseId> --project <id> -e <mockEnvId> -r cli,json
apidog run --test-case <caseId> --project <id> -e <freeTierEnvId> -r cli

CI では -r junit を付けてモック環境のみを実行します(パイプラインファイルはApidog CLI CI/CD ガイドに、エージェントのセットアップは Apidog CLI in Claude Code にあります)。Apidog の Free プランは最大 4 ユーザーまで対応しているため、小規模チームは無料でモックを共有できます。OpenAI のバージョンも検討中ですか?そちらは OpenAI Decisions API の解説記事を参照してください。

FAQ

Gemini Decisions API は無料ですか? はい、制限内であれば無料です。無料枠では入力は無課金で、出力は常に 0 トークンです。プロジェクトあたり毎分 200 リクエスト、毎分 50,000 トークン、1 日 10,000 リクエストまで利用できます。それを超える場合は課金設定を行い、入力 100 万トークンあたり $0.10 を支払います。

Gemini Decisions API の無料枠にクレジットカードは必要ですか? いいえ。Google AI Studio で取得した API キーは無料枠で開始します。Google のレート制限ページによると、AI Studio で課金設定を行った後にのみ有料枠へ移行します。

Google は無料枠の Decisions API データでトレーニングを行いますか? Google の価格ページでは「当社製品の改善に使用」が無料枠では「あり」、有料では「なし」とされています。無料枠のキーは機密性の高いデータには適さないものとして扱ってください。

毎分 200 リクエストに遠く及ばないのに 429 エラーが出るのはなぜですか? おそらく毎分 50,000 トークンを超えています。画像、音声、PDF の入力はトークンを大量に消費するため、RPM より先に TPM が上限に達しがちです。usage.total_input_tokens を記録し、その数値で 50,000 を割った値にリクエストのペースを合わせてください。

OpenRouter に無料の Gemini Decision 1 モデルはありますか? 2026 年 11 月 12 日時点ではありません。OpenRouter では google/gemini-decision-1 が入力 100 万トークンあたり $0.10、出力 $0 で提供されており、:free バリアントはありません。

Batch API やコンテキストキャッシュで無料枠を延長できますか? できません。モデルページでは、Batch API とキャッシュはどのティアでも非対応とされています。質問を 1 つのリクエストにまとめ、回答は自分のコード内でキャッシュしてください。