Gemini 3.7 Flash のデベロッパー ガイド

Gemini 3.7 Flash は、デベロッパー向けのインテリジェントな日常的なドライバであり、ソフトウェア エンジニアリングを一段階進め、ビルドが明らかに改善されます。このモデルは、複雑なタスク、指示の遵守、ツール呼び出しのインテリジェンスを日々のワークフローに導入します。

このドキュメントでは、3.7 Flash の新機能、Gemini モデル ファミリー内での位置付け、3.7 Flash への移行方法について説明し、3.7 Flash の使用に関するクイックスタートを提供します。

Gemini ファミリー内での位置付け

Gemini 3.7 Flash は、Gemini 3 ファミリーの主要なエージェント型ワークホースであり、高度な推論を行う Pro モデルと高スループットの Gemini Flash-Lite モデルのギャップを埋めながら、高いトークン効率とマルチステップのマルチモーダル処理を実現します。

モデル仕様と比較

次の表は、3.7 Flash、3.6 Flash、3.1 Pro の仕様の一部を比較したものです。

サポートされている機能、ツール、使用オプションの完全なリストについては、3.7 Flash モデル のページをご覧ください。

Gemini 3.7 Flash の新機能

次の表は、Gemini 3.7 Flash と 3.6 Flash の標準的なデベロッパー評価ベンチマークを比較したものです。

クイックスタート

始める前に、アプリケーションのデフォルト認証情報（ADC）または API キーを使用して Agent Platform に対する認証を行う必要があります。詳細については、Gemini Enterprise Agent Platform を使ってみるをご覧ください。

次のコードブロックで、PROJECT_ID をプロジェクト ID に置き換えます。

インストール

最新の google-genai SDK を使用していることを確認します。

pip install --upgrade google-genai

基本的なリクエスト

from google import genai

client = genai.Client(enterprise=True, project="PROJECT_ID", location="global")

response = client.models.generate_content(
  model="gemini-3.7-flash",
  contents="How does AI work?",
)
print(response.text)

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/google/models/gemini-3.7-flash:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "Why is the sky blue?" },
  },
}'

必須の API ルールと動作の慣例

Gemini 3.7 Flash では、Gemini 3 ファミリーの標準的な API 規約が厳格に適用されます。

• 非推奨のサンプリング パラメータ（temperature、top_k、top_p）: これらのパラメータはバックエンドで無視されます。代わりに、thinking_level（LOW、MEDIUM、HIGH）と response_schema または json_schema を使用して決定論を制御できます。
• サポートされていないパラメータ（frequency_penalty、presence_penalty、candidate_count）: frequency_penalty、presence_penalty、candidate_count を渡すと、アクティブな API エラーがスローされます。レガシー クライアント コードから削除してください。

• 厳格な関数呼び出しルール: FunctionResponse ターンは、前の FunctionCall の id、name、実行回数と厳密に一致する必要があります。

  • マルチモーダル アセット: マルチモーダル アセットは常に レスポンス ペイロード内に配置します。
  • 書式設定とツール前のテキスト: インライン命令の書式設定には \n\nを使用します。ツール前のテキストに関連する Malformed_Function_Call エラーが発生した場合は、ツール呼び出しの前に先頭のコメントをクリーンアップします。

  • ツール呼び出しの前に中間作業メモやステータス更新を渡すには、未加工の XML やテキストを出力するのではなく、専用の update() 関数呼び出しでラップします。

    {
      "name": "update",
      "description": "Update working notes before tool execution",
      "parameters": {
        "type": "OBJECT",
        "properties": {
          "previous_step": {"type": "STRING"},
          "plan": {"type": "STRING"},
          "next_step": {"type": "STRING"}
        },
        "required": ["previous_step", "plan", "next_step"]
      }
    }
    

• チャット シーケンスの検証:

  • 履歴ペイロードは「model」ロールターンで終わることはできません。
  • 事前入力済みモデルターンはサポートされていません。アップグレード時に削除する必要があります。
  • 会話履歴の空のターンは自動的に削除されるか、検証エラーが発生します。

3.5 Flash または 3.6 Flash から 3.7 Flash に移行する

3.5 Flash または 3.6 Flash から 3.7 Flash に移行する手順は次のとおりです。

1. モデル ID を更新する: API 呼び出しのモデル文字列を gemini-3.7-flashに変更します。
2. 推論予算パラメータを置き換える: 整数 thinking_budget 構成を、次のいずれかの値に設定された文字列列挙型 thinking_level に置き換えます:
   • HIGH: 密度の高いビジュアル QA、一瞬の動きの検出（スポーツ、編集）、60 分以上の動画でのマルチステップの推論におすすめします。
   • MEDIUM: デフォルトの思考レベル。このレベルは、一般的な動画の Q&A、講義の要約、クリップの取得に最適なバランスを提供します。
   • LOW: 高速な文字起こしに重点を置いた検索や基本的なメタデータの抽出などのタスクにおすすめします。
3. 非推奨のパラメータとサポートされていないパラメータを削除する:
   • temperature、top_p、top_k を削除します。
   • candidate_count、frequency_penalty、presence_penalty を削除します。
   • 会話履歴から事前入力済みモデルターンを削除します。

デベロッパー向けの概要チェックリスト

参考情報

• Gemini 3.7 Flash モデルのページ
• 入門ノートブック