0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Gemini 3系モデル本格展開とAPI新機能・移行ガイド総まとめ

0
Posted at

はじめに

Google の Gemini API エコシステムが大きな転換期を迎えています。Gemini 3 シリーズが本格展開され、3.1 Pro / Flash / Flash-Lite までラインナップが揃いました。同時に、ビルトインツールと Function Calling の併用、マルチモーダル埋め込みモデルなど開発者向けの強力な新機能が次々と追加されています。

一方で、Gemini 2.0 系モデルの段階的廃止が進行中です。2026年6月1日には Flash / Flash Lite がシャットダウンされるため、移行対応が急務となっています。

この記事では、2025年末〜2026年3月にかけての主要な変更を整理し、開発者が今すぐ把握すべきポイントと対応アクションをまとめます。

📌 影響を受ける人

  • Gemini API を利用しているすべての開発者
  • エージェント・RAG アプリケーションを構築している方
  • Gemini 1.5 / 2.0 系モデルをまだ使用している方
  • 埋め込みモデルやマルチモーダル処理を活用している方

変更の全体像

Gemini エコシステムの変遷とモデルライフサイクルを図で整理します。

モデル世代の移行状況を俯瞰すると、以下のようになります。

変更内容

1. ビルトインツールと Function Calling の併用(severity: high)

2026年3月18日、ビルトインツール(Google Search、Code Execution など)とカスタム Function Calling を単一の API コールで併用できるようになりました。

従来は、Google Search で情報を取得してからカスタム関数を呼ぶ場合、2回の API コールが必要でした。今回の変更で、1回のリクエストですべてのツールを組み合わせた処理が可能になり、エージェント構築の柔軟性が大幅に向上します。

💡 Tips
この機能は Gemini 3 系モデルで利用可能です。エージェントフレームワークを構築している方は、ツール呼び出しのオーケストレーションを簡素化できるチャンスです。

2. マルチモーダル埋め込みモデル gemini-embedding-2-preview(severity: high)

2026年3月10日にリリースされた gemini-embedding-2-preview は、テキスト・画像・動画・音声・PDF を統一的な埋め込み空間にマッピングする初のマルチモーダル埋め込みモデルです。

特徴 詳細
対応モダリティ テキスト、画像、動画、音声、PDF
ユースケース クロスモーダル検索、類似度計算
API Embeddings API
ステータス Preview

従来はモダリティごとに別々の埋め込みモデルを使い分ける必要がありましたが、このモデルにより**「画像で検索してテキストを見つける」「音声に類似した動画を検索する」**といったクロスモーダル検索がシンプルに実現できます。

3. Gemini 3 Pro Preview シャットダウンと 3.1 Pro へのリダイレクト(severity: high)

⚠️ Breaking Change
gemini-3-pro-preview は2026年3月9日にシャットダウンされ、同エイリアスは自動的に gemini-3.1-pro-preview にリダイレクトされます。挙動に差異がある可能性があるため、テストの実施が推奨されます。

4. Gemini 3.1 Pro Preview と customtools エンドポイント(severity: high)

2026年2月19日にリリースされた Gemini 3.1 Pro Preview には、通常版に加えて gemini-3.1-pro-preview-customtools という専用エンドポイントが提供されています。

エンドポイント 特徴 推奨ユースケース
gemini-3.1-pro-preview 汎用 一般的な推論・生成タスク
gemini-3.1-pro-preview-customtools カスタムツール優先 bash + ツール連携のエージェント構築

5. Gemini 3.1 Flash-Lite Preview(severity: high)

2026年3月3日リリース。Gemini 3 シリーズ初の Flash-Lite モデルで、高速・低コストなユースケースに最適化されています。大量のリクエストを捌く必要がある本番ワークロードでの利用が想定されます。

6. Gemini 2.0 Flash / Flash Lite 廃止予告(severity: high)

⚠️ Breaking Change
以下のモデルが 2026年6月1日にシャットダウンされます。

  • gemini-2.0-flash
  • gemini-2.0-flash-001
  • gemini-2.0-flash-lite
  • gemini-2.0-flash-lite-001

Gemini 3 系モデルへの移行が必須です。

7. Gemini 1.5 シリーズ全モデル廃止完了(severity: high)

2025年9月29日に gemini-1.5-progemini-1.5-flashgemini-1.5-flash-8b がすべてシャットダウン済みです。まだ 1.5 系のモデル ID をハードコードしている箇所がある場合は、即座に更新が必要です。

8. その他の注目アップデート

変更 日付 概要
Interactions API + Deep Research Agent 2025/12/11 モデル・エージェントとの統一 IF。自律型マルチステップリサーチ
Gemini 3 Flash Preview 2025/12/17 フロンティアクラス性能を低コストで実現
Computer Use ツール 2026/1/29 Gemini 3 Pro/Flash でコンピュータ操作対応
Grounding with Google Maps 2026/3/18 Gemini 3 で地理情報グラウンディング
latest エイリアス切替 2026/1/21 gemini-pro-latest → Gemini 3 系に変更
Fine-tuning サポート終了 2025/5/27 全モデルでチューニング非対応に

影響と対応

移行判断フローチャート

対応アクション一覧

優先度 アクション 期限
🔴 緊急 Gemini 1.5 系を使用している場合は即座に移行 即時
🔴 高 gemini-3-pro-preview 利用者は 3.1 での動作をテスト 即時
🟡 中 Gemini 2.0 Flash / Flash Lite からの移行計画策定 2026/6/1
🟡 中 gemini-2.5-flash-lite-preview-09-2025 の移行 2026/3/31
🟡 中 latest エイリアス使用箇所の動作確認 早期推奨
🟢 低 ビルトインツール + FC 併用機能の活用検討 任意
🟢 低 マルチモーダル埋め込みモデルの評価 任意

コード例

ビルトインツールと Function Calling の併用

Before: 2回の API コールが必要

from google import genai

client = genai.Client()

# 1回目: Google Search で情報取得
response1 = client.models.generate_content(
    model="gemini-3.1-pro-preview",
    contents="東京の今日の天気は?",
    config=genai.types.GenerateContentConfig(
        tools=[genai.types.Tool(google_search=genai.types.GoogleSearch())]
    ),
)
search_result = response1.text

# 2回目: カスタム関数で処理
response2 = client.models.generate_content(
    model="gemini-3.1-pro-preview",
    contents=f"以下の天気情報をもとに服装を提案して: {search_result}",
    config=genai.types.GenerateContentConfig(
        tools=[genai.types.Tool(function_declarations=[{
            "name": "suggest_outfit",
            "description": "天気に合った服装を提案する",
            "parameters": {
                "type": "object",
                "properties": {
                    "weather": {"type": "string"},
                    "temperature": {"type": "number"}
                }
            }
        }])]
    ),
)

After: 1回の API コールで完結

from google import genai

client = genai.Client()

# ビルトインツールとカスタム関数を1回のリクエストで併用
response = client.models.generate_content(
    model="gemini-3.1-pro-preview",
    contents="東京の今日の天気を調べて、適切な服装を提案して",
    config=genai.types.GenerateContentConfig(
        tools=[
            # ビルトインツール
            genai.types.Tool(google_search=genai.types.GoogleSearch()),
            # カスタム関数
            genai.types.Tool(function_declarations=[{
                "name": "suggest_outfit",
                "description": "天気に合った服装を提案する",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "weather": {"type": "string"},
                        "temperature": {"type": "number"}
                    }
                }
            }]),
        ]
    ),
)

マルチモーダル埋め込みの利用例

from google import genai

client = genai.Client()

# テキストの埋め込み
text_result = client.models.embed_content(
    model="gemini-embedding-2-preview",
    contents="東京タワーの写真",
)

# 画像の埋め込み(同じ埋め込み空間)
image_result = client.models.embed_content(
    model="gemini-embedding-2-preview",
    contents=genai.types.Content(
        parts=[genai.types.Part.from_image("tokyo_tower.jpg")]
    ),
)

# クロスモーダル類似度計算が可能
import numpy as np
similarity = np.dot(text_result.embeddings[0].values,
                    image_result.embeddings[0].values)
print(f"テキストと画像の類似度: {similarity:.4f}")

モデル移行の例

# Before: 廃止予定のモデル
# response = client.models.generate_content(
#     model="gemini-2.0-flash",  # ⚠️ 2026/6/1 に廃止
#     contents="..."
# )

# After: Gemini 3 系への移行
response = client.models.generate_content(
    model="gemini-3.1-pro-preview",  # ✅ 最新モデル
    contents="...",
)

# 高速・低コスト用途の場合
response = client.models.generate_content(
    model="gemini-3.1-flash-lite-preview",  # ✅ Flash-Lite
    contents="...",
)

まとめ

  1. Gemini 3 シリーズが本格展開: 3.1 Pro / Flash-Lite / Flash Image まで揃い、customtools 専用エンドポイントも追加。エージェント構築の選択肢が大幅に増えた
  2. ビルトインツール + Function Calling 併用: 単一 API コールでの統合利用が可能に。エージェントのアーキテクチャを簡素化できる
  3. マルチモーダル埋め込みモデル: テキスト・画像・動画・音声・PDF を統一空間に埋め込み、クロスモーダル検索が実現
  4. 廃止モデルの移行は計画的に: Gemini 1.5 系は既に廃止済み、2.0 Flash 系は 2026/6/1 まで。gemini-3-pro-preview は 3.1 へ自動リダイレクト中
  5. Fine-tuning は現在非対応: 全モデルでチューニングサポートが終了。プロンプトエンジニアリングや Few-shot での対応が必要

特に Gemini 2.0 Flash 系を本番環境で使用している方は、6月1日のシャットダウンに向けて早めの移行計画策定をお勧めします。Gemini 3.1 系は Preview 段階ですが、customtools エンドポイントなどエージェント構築に特化した機能も充実しており、移行先として有力な選択肢です。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?