🔦

Google AI Studio(Gemini API) - どのモデルを使用する?

に公開

はじめに

こんにちは!駆け出しエンジニアcrocoです。

Google AI Studio(Gemini API)を使ってPythonでアプリを作る時など、「どのモデルを使えばいいの?」と迷ったことはありませんか?

私も最初は公式ドキュメントを見ても、実際にどのモデルが使えるのかよく分からず、エラーに悩まされました。

この記事では、自分のAPIキーで利用可能なモデル名を確認する方法と、初学者向けのモデルの選び方を、過去の自分に向けて書いています。

この記事で分かること

  • Pythonで利用可能なGeminiモデルの一覧を取得する方法
  • モデル名の見方と選び方の基準
  • 初学者におすすめのモデル

手順

Step 1: モデル確認用のPythonファイルを作成

まず、プロジェクトフォルダ内にcheck_models.pyという新しいファイルを作成します。

# プロジェクトフォルダ内で実行
touch check_models.py

Step 2: コードを貼り付ける

以下のコードをcheck_models.pyにコピー&ペーストしてください。

import os
import google.generativeai as genai
from dotenv import load_dotenv
import sys

# .envファイルから環境変数を読み込む
load_dotenv()

# APIキーを設定
api_key = os.getenv("GOOGLE_API_KEY")
if not api_key:
    print("エラー: GOOGLE_API_KEYが設定されていません。", file=sys.stderr)
    sys.exit(1)

genai.configure(api_key=api_key)

print("利用可能なモデルの一覧を取得します...\n")

# 利用可能なモデルをリストアップ
for model in genai.list_models():
    # 'generateContent'(文章生成)が可能なモデルのみを表示する
    if 'generateContent' in model.supported_generation_methods:
        print(model.name)

Step 3: スクリプトを実行する

ターミナルで以下のコマンドを実行します。

python3 check_models.py

Step 4: 実行結果を確認する

実行すると、ターミナルに以下のような形式で利用可能なモデル名の一覧が表示されます。

利用可能なモデルの一覧を取得します...

models/gemini-2.5-pro-preview-03-25
models/gemini-2.5-flash-preview-05-20
models/gemini-2.5-flash
models/gemini-2.0-flash-exp
models/gemini-2.0-flash
models/gemini-pro-latest
models/gemini-flash-latest
...

モデルの選び方:3つの基準

たくさんのモデル名が出てきて、どれを選べばいいか迷いますよね。初学者が安定してアプリを作るために、以下の3つのポイントを押さえましょう。

基準1: 「-latest」が付く安定版を選ぶ ✅

モデル名の末尾に-latestが付いているものは、そのシリーズの最新の安定版です。

Googleがモデルを更新しても自動的に最適なバージョンが使われるため、コードを修正する必要がありません。

  • おすすめ:models/gemini-pro-latest
  • おすすめ:models/gemini-flash-latest

基準2: 「preview」や「exp」が付く実験版は避ける ❌

preview(プレビュー版)やexp(実験版)という名前が含まれるモデルは、テスト目的で公開されています。

仕様が突然変更されたり、有料だったり、利用できなくなる可能性があるため、安定したアプリを作るのには不向きです。

  • 避けるべき:models/gemini-2.5-pro-preview-03-25
  • 避けるべき:models/gemini-2.0-flash-exp

基準3: 用途が限定されたモデルは避ける ❌

モデル名にimage-generation(画像生成)やtts(音声合成)など、特定の目的が入っているものは、文章生成以外の特殊な用途のモデルです。

  • 避けるべき:models/gemini-2.0-flash-exp-image-generation
  • 避けるべき:models/gemini-2.5-flash-preview-tts

初学者におすすめのモデル2選

1. models/gemini-pro-latest (最もおすすめ!)

  • **特徴:**性能と安定性のバランスが取れた標準モデル
  • **用途:**文章生成、要約、質問応答など幅広い用途に対応
  • **おすすめ理由:**初学者がまず試すべき、最も安定したモデルです

2. models/gemini-flash-latest

  • 特徴:proよりも高速な応答が特徴
  • **用途:**速さを重視する場合や、コストを抑えたい場合
  • **おすすめ理由:**無料枠を超えて有料利用する場合、proより料金が安い

実際にモデルを使ってみる

確認したモデル名を使って、実際にコードに組み込んでみましょう。

import os
import google.generativeai as genai
from dotenv import load_dotenv

load_dotenv()
genai.configure(api_key=os.getenv("GOOGLE_API_KEY"))

# おすすめのモデルを指定
model = genai.GenerativeModel("models/gemini-pro-latest")

# 文章生成を試してみる
response = model.generate_content("Pythonの魅力を3つ教えてください")
print(response.text)

おわりに

この記事が、過去の私と同じように「どのモデルを使えばいいの?」と迷っている方の助けになれば嬉しいです。

Google AI Studioは無料でも十分使えるので、ぜひいろいろ試してみてください!

参考リンク

Discussion