最新の Gemini モデルを使用する

このページでは、 3.5 Flash について説明します。

Gemini 3.6 Flash（gemini-3.6-flash）と Gemini 3.5 Flash-Lite（gemini-3.5-flash-lite）は一般提供（GA）されており、本番環境で使用できます。

• Gemini 3.6 Flash: 複雑なエージェント タスクとマルチモーダル タスクでパフォーマンスが向上し、トークン使用量が削減され、3.5 Flash よりも低価格です。
• Gemini 3.5 Flash-Lite: 3.5 ファミリーで最も高速で低コストのモデルです。高スループットの実行において、以前の Flash-Lite 世代よりも優れています。

このガイドでは、各モデルの新機能、コードに影響する API の変更、移行方法について説明します。

新モデル

どちらのモデルも、100 万トークンのコンテキスト ウィンドウ、最大 64,000 個の出力トークン、思考、Computer Use を含む組み込みツールのフルパッケージをサポートしています。

完全な仕様については、モデルページをご覧ください。

• Gemini 3.6 Flash モデルページ
• Gemini 3.5 Flash-Lite モデルページ

料金の詳細については、料金ページをご覧ください。

クイックスタート

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-3.6-flash",
    contents="Write a three.js script that renders an interactive 3D robot.",
)

print(response.text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3.6-flash",
    contents: "Write a three.js script that renders an interactive 3D robot.",
  });
  console.log(response.text);
}

main();

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [{"text": "Write a three.js script that renders an interactive 3D robot."}]
    }]
  }'

Gemini 3.6 Flash の新機能

• トークンとターンの削減: Gemini 3.5 よりも少ない推論ステップ、会話ターン、ツール呼び出しで、複数ステップのワークフローを完了します。また、実行ループの増加も軽減されます。
• コード生成の改善: 不要な編集やデバッグ ループを減らし、高品質で本番環境に対応したコードを生成します。
• 指示の遵守の改善: 診断タスク中の不要なファイル変更を減らします。
• 強力なマルチモーダル推論と空間推論: チャートの解釈、ビジュアル ブループリントの変換、マルチ要素のウェブ レイアウト生成のパフォーマンスが向上しました。
• 事前プログラムによる検査: Gemini 3.5 Flash よりも頻繁に、変更を加える前に診断コード スクリプトを実行します。これにより、複雑なタスクの精度が向上しますが、簡単なフロントエンド作業で追加の探索ステップが必要になる場合があります。
• Computer Use のサポート: エージェント UI 自動化のネイティブ ツールとしてサポートされています。
• UI スタイルの設定: 機能コードの作成には優れていますが、人間の評価者はビジュアル レイアウトとスタイリングで以前のモデルを好んでいました。明示的なデザイン ガイドラインを提供することで、この問題を軽減できます。
• デフォルトの思考量（中）: Gemini 3.5 Flash と同じ medium のデフォルトの思考レベルを使用します。
• 料金の引き下げ: 出力トークンの費用が削減されました（3.5 Flash の場合 $9.00/100 万トークンに対し、$7.50/100 万トークン）。入力トークンは $1.50/100 万トークンのままです。

Gemini 3.5 Flash-Lite の新機能

• タスク実行のレイテンシの短縮: 大量のデータ解析とドキュメント抽出で、3.5 ファミリーで最高のスループットを実現します。
• 推論とマルチモーダル パフォーマンスの強化: Gemini 2.5 Flash からの強力な移行パス。HLE（18.0% 対 11.0%）などの推論タスクや、CharXIV（74.5% 対 63.7%）などのマルチモーダル ベンチマークで高いスコアを獲得しています。
• サブエージェントのオーケストレーションとツールの信頼性: コード実行、検索、MCP ワークフローのツール実行の信頼性が向上します。自律的なプランニングと複雑なサブエージェント タスクでは、思考レベルを上げます。
• ドキュメント理解の改善: ドキュメントの解析と構造化データの抽出の精度が向上します。ドキュメントの複雑さに応じて、最小思考レベルと高思考レベルの両方を試してください。
• インタラクティブなウェブ コーディングと表形式のデータ処理: 軽量なコード実行によるプランニングにより、フロントエンド JavaScript と表形式のデータ処理で優れたパフォーマンスを発揮します。
• chatbot とペルソナの永続性: Gemini 3.1 Flash-Lite よりも、複数ターンの指示の遵守とペルソナの一貫性が向上しています。
• Computer Use のサポート: エージェント UI 自動化のネイティブ ツールとしてサポートされています。

適切な Flash モデルまたは Flash-Lite モデルを選択する

この表を使用して、ワークロードに適したモデルと移行パスを選択してください。

どちらのモデルでも、非推奨のサンプリング パラメータ（temperature、top_p、top_k）と事前入力されたモデルターンを削除する必要があります。詳細については、API の変更をご覧ください。

更新された Antigravity エージェント

パフォーマンスが向上したため、Gemini 3.6 Flash は、Gemini Managed Agents の Antigravity エージェントを強化する新しいデフォルト モデルになりました。これは、API に新しいフィールドを設定することで変更できます。

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input="Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment="remote",
)

print(interaction.output_text)

import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    agent: "antigravity-preview-05-2026",
    input: "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment: "remote",
}, { timeout: 300000 });

console.log(interaction.output_text);

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
    "agent": "antigravity-preview-05-2026",
    "input": "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    "environment": "remote"
}'

API の変更とパラメータの更新

Gemini 3.6 Flash と Gemini 3.5 Flash-Lite 以降、次の API の変更がこれらのモデルと今後のすべての Gemini モデル リリースに適用されます。

• サンプリング パラメータの非推奨: temperature、top_p、top_k は非推奨になりました。API はこれらのパラメータを無視し、今後のモデル生成でエラーを返します。
• 事前入力されたモデルターンの検証: モデルターンの事前入力はサポートされなくなりました。リクエストの最後の空でないターンが model ターンである場合、API は 400 エラーを返します。

以下に、各 API の変更の詳細な説明とコードサンプルを示します。

1. サンプリング パラメータの非推奨（temperature、top_p、top_k）

temperature、top_p、top_k は非推奨となり、無視されます。今後のモデル生成では、これらのパラメータを指定すると HTTP 400 エラーが返されます。すべてのリクエストからこれらのパラメータを削除してください。

# ⚠️ Remove these parameters (deprecated)
generation_config = {
     "temperature": 0.7,
     "top_p": 0.9,
     "top_k": 40,
}

決定性を高めるには、特定のユースケースの明示的なルールを使用してシステム指示を定義します。

2. 事前入力されたモデルターンの検証

空でないモデルロールターンで終わる API リクエストは許可されず、HTTP 400 エラー が返されます。

⚠️ 避ける

従来の generateContent または未加工の REST ペイロードでは、モデルロールターンで終わることは許可されなくなりました。

/* ❌ DO NOT: End payload contents with a 'model' role turn */
{
  "contents": [
    {"role": "user", "parts": [{"text": "Translate 'Hello world' to Spanish."}]},
    {"role": "model", "parts": [{"text": "Translation:"}]}  /* ❌ Returns error */
  ]
}

✅ 推奨される移行

アプリケーションで以前にモデルターンを事前入力してプリアンブルを抑制したり、JSON 形式を強制したりしていた場合は、代わりに system_instruction または 構造化出力 を使用してください。

# ✅ RECOMMENDED: Use system_instruction to specify output format
response = client.models.generate_content(
    model="gemini-3.6-flash",
    contents="Translate 'Hello world' to Spanish.",
    config={"system_instruction": "Output only the translation without introductory text."},
)

移行チェックリスト

gemini-3.6-flash に移行する

• モデル ID を更新する: ターゲット モデル文字列を gemini-3.6-flash に変更します。
• 非推奨のサンプリング パラメータを削除する:
  • 生成構成から temperature、top_p、top_k を削除します。
  • thinking_budget を、"medium" または "high" に設定された文字列列挙型 thinking_level に置き換えます。
  • candidate_count を削除します（Gemini 3.x ではサポートされていません）。
• ターン検証ルールを適用する:
  • 事前入力されたモデルターンを削除します。
  • 最後のユーザーターンに空でないテキストが含まれていることを確認します。
• 関数呼び出しを監査する:
  • すべての FunctionResponse オブジェクトに call_id と name が含まれていることを確認します。
  • マルチモーダル アセットをレスポンス ペイロード内に配置します。
  • \\n\\n を使用してインライン指示の形式を設定します。
  • ツール前のテキストに関連する Malformed_Function_Call エラーが表示される場合は、ツール前のテキスト要件の回避策をご覧ください。
• Gemini 3.x のベースライン要件: SDK の更新と思考シグネチャの保持については、Gemini 3.5 の移行チェックリストをご覧ください。

gemini-3.5-flash-lite に移行する

• モデル ID を更新する: ターゲット モデル文字列を gemini-3.5-flash-lite に変更します。
• 思考量のレベルを構成する:
  • 大量の抽出、ルーティング、分類の場合は、thinking_level を "minimal"（デフォルト）のままにして、最大スループットを実現します。
  • ツール呼び出し、コード実行、複数ステップの推論を行う自律型サブエージェントの場合は、thinking_level を "medium" または "high" に設定して、ツールの早期終了を防ぎます。
• 非推奨のパラメータを削除して関数呼び出しを検証する: 3.6 Flash と同じルールを適用します。
• Gemini 3.x のベースライン要件: Gemini 3.5 の移行チェックリストをご覧ください。

次のステップ

• モデルの概要で API 仕様を確認する。
• Interactions API ガイドでマルチエージェント オーケストレーションについて調べる。
• Google AI Studio でプロンプトをテストして改善する。