Gemini APIの使い方｜キー取得・Python実行例・料金とエラー対処

Gemini APIは、Google AI StudioでAPIキーを用意し、公式SDK「google-genai」を導入して、プログラムからモデルへリクエストすると使えます。Pythonなら、キーの設定→SDKの導入→短い文章を1回生成→応答と使用量の確認、の順で進めると、問題のある箇所を切り分けやすくなります。

この記事ではGemini Developer APIをPythonから使う方法を扱います。ブラウザで対話するGeminiアプリや、Google CloudのVertex AIの設定手順とは別です。コードは2026年11月2日に確認した公式ドキュメントを基にした説明例で、当研究所が利用者のキーで実行した結果ではありません。

最初に必要なものと、APIでできること

• 利用条件を満たすGoogleアカウントと、アクセスできるGoogle AI Studioのプロジェクト
• そのプロジェクトで利用できるAPIキーと、対象モデルの使用枠
• Pythonの実行環境。以下はPython 3.11以降を想定し、実際の対応版は公式SDKの要件も確認
• 無料枠か有料枠かを把握し、入力してよいデータを決めた状態

たとえば、自社が権利を持つ商品説明から短い要約を作る、問い合わせ文を分類する、原稿の表記揺れを抽出するといった処理を、自分のアプリやバッチへ組み込めます。最初から顧客データを大量投入せず、短い説明文1件で接続を確認しましょう。

Google公式のスタートガイドは現在Interactions APIを案内しています。古い記事のSDK名やモデル名を混在させず、使用するAPIとSDKの組み合わせをそろえてください。

手順1：Google AI StudioでAPIキーを確認する

1. Google AI Studioに自分のアカウントでログインします。
2. APIキーの管理画面で、使用するプロジェクトとキーを確認します。必要なら画面の案内に従って新規作成します。
3. キーとプロジェクトの対応、使用量、料金区分を確認します。会社の環境では作成権限のある管理者へ相談します。
4. キーを安全な場所で扱い、ソースコード・Git・共有画像・問い合わせ本文には記載しません。

公式は新規利用者向けにプロジェクトとキーを自動作成する場合も案内しています。「新規作成ボタンを必ず押す」ではなく、どのプロジェクトの利用として記録されるかを確認することが重要です。詳細はAPIキーの公式ガイドを参照してください。

ブラウザで動く公開JavaScriptへキーを埋め込むと、第三者が取得できる可能性があります。Webサービス化する場合はサーバー側で管理し、アクセス制限や濫用対策を設計します。キーを公開してしまった場合は、そのキーを無効化して作り直し、利用履歴も確認してください。

手順2：SDKを入れ、最小コードを実行する

以下は自分の端末で入力するコマンドです。WindowsではPowerShell等、macOS・Linuxではターミナルを使います。既存の業務プログラムと混ぜたくない場合は、先に作業専用の仮想環境を用意してください。

python -m pip install -U google-genai

次をgemini_demo.pyとして保存します。環境変数GEMINI_API_KEYがあればそれを利用し、なければ非表示入力でキーを受け取る例です。getpassが非表示入力に対応する端末で実行し、共有ノートブックの入力欄へキーを書かないでください。

import os
from getpass import getpass
from google import genai

api_key = os.environ.get("GEMINI_API_KEY")
if not api_key:
    api_key = getpass("Gemini API key (入力は表示されません): ")

client = genai.Client(api_key=api_key)
result = client.interactions.create(
    model="gemini-3.8-flash",
    input="次の商品説明を一文で要約してください。商品：折りたたみ式の机。幅80cm。室内用。"
)

if not result.output_text:
    raise RuntimeError("文章の応答が空です。結果の状態と公式のエラー案内を確認してください。")

print(result.output_text)

python gemini_demo.py

キーを入力するとAPI呼び出しが発生します。実行前に、選んだモデルを自分の料金区分・地域・プロジェクトで利用できるか確認してください。ここでは公式スタートガイドのモデル指定を使用していますが、利用できない場合は公式モデル一覧と管理画面を照合します。

手順3：何が出れば成功なのかを確認する

端末に「室内用の幅80cmの折りたたみ式机です」のような要約が表示されれば、少なくともそのリクエストでテキストの応答を受け取れたと判断できます。これは期待する出力の説明例で、実行ログではなく、同じ文面が必ず返るという意味でもありません。

1. プロセスがエラー終了していないか確認する。
2. 応答に、元の説明にない価格・材質・保証が追加されていないか照合する。
3. Google AI StudioのUsageで、対象プロジェクトの使用状況を確認する。反映の遅延も考慮する。
4. 使用したモデル・日時・入力文字量・結果を、キーを含めずに記録する。

「通信が成功した」「要約が正しい」「業務で使える」の3つは別の判定です。続いて数件のサンプルで、仕様を勝手に補っていないか、出力形式が安定しているかを確かめてから件数を増やします。

無料枠と有料枠、アプリの有料契約は分けて考える

API公式料金表では、今回のGemini 3.8 Flashの標準テキスト処理に無料枠があります。有料枠は2026年12月31日まで入力0.75ドル・出力3.75ドル／各100万トークン、2027年1月1日から入力1.50ドル・出力7.50ドルという掲載です。将来の切り替え日も見落とさないでください。

仮に有料枠で入力100万・出力20万トークンを使った場合、2026年内の上記単価なら0.75＋3.75×0.2＝1.50ドルです。標準処理だけの説明用計算で、検索連携・保存・別モデル等の料金は含みません。無料枠では入力が製品改善に使われる旨の記載もあるため、顧客情報や秘密情報の試験投入は避け、利用条件を確認してください。

動かないときはエラーの種類で切り分ける

正確な理由はHTTP番号だけでなくエラー本文も確認します。ただし、ログを共有する際はキーと入力データを伏せます。再試行方法は公式トラブルシューティングへ照合し、課金不足・権限・文法の問題を無限再試行で解決しようとしないでください。

業務へ組み込む前に追加するもの

最小例から本番へ進むときは、入力サイズの上限、処理件数の上限、タイムアウト、失敗時の保存・再実行、結果を確認する担当者を加えます。問い合わせ分類なら、人の判断が必要な文面を分ける行き先も必要です。文章生成の成功だけで、顧客への自動送信まで許可したことにはしません。

最初の目標は「AIシステムを完成させる」ではなく、自分のプロジェクトで、1件の入力から期待する種類の出力を安全に確認できることです。その後に料金と品質を測りながら、継続利用の可否を決めましょう。

ツールの選び方や業務での使い分けに迷う場合は、AI活用・マーケティングの相談窓口をご利用ください。