Gemini 4 を使ってみる

最初の Gemini 4 モデルは Gemini 4 Argon（gemini-4-argon）です。これは、コーディング、金融、法律、サイバーセキュリティ、科学などの分野で、複雑な現実世界のタスクにおけるディープワークに優れた Google のフロンティア モデルです。

このガイドでは、最初の Gemini 4 リクエストを行う方法、Gemini 4 の新機能、Gemini 3.1 Pro から移行する際の変更点について説明します。モデル固有の詳細については、Gemini 4 Argon のデベロッパー ガイドをご覧ください。

クイックスタート

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

Google Gen AI SDK をインストールする

最新の google-genai SDK（Python の場合は >= 2.30.0）にアップグレードします。

pip install --upgrade "google-genai>=2.30.0"

環境変数を設定する

GOOGLE_CLOUD_PROJECT は、実際の Google Cloud プロジェクト ID に置き換えます。Gemini 4 Argon は、global エンドポイントと us および eu のマルチリージョンで使用できます。

export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

最初のリクエストを送信する

Python

from google import genai

client = genai.Client()

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

REST

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-4-argon:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "How does AI work?" }
  }
}'

Gemini 4 の新機能

コンテキスト ウィンドウと出力の上限

1,048,576 トークンのコンテキスト ウィンドウは、入力トークン、思考トークン、出力トークンで共有されます。デフォルトでは、1 つの同期リクエストで最大 65,536 個の思考トークンと出力トークンが生成されます（ストリーミング以外の直接 HTTP リクエストの場合は 32,768 個）。

長いデコード

1 回のターンで 65,536 個（非ストリーミングの直接 HTTP 呼び出しの場合は 32,768 個）を超える出力トークンと思考トークンが必要な場合（正式な証明、複雑な数学や科学の問題、複数ファイルのコード生成など）、Gemini 4 Argon は GenerateContent（generateContent と streamGenerateContent）で最大 1,048,576 トークンの長いデコードをサポートします。最新の Google Gen AI SDK（Python の場合は google-genai >= 2.30.1）では、max_output_tokens を 65,536 より大きく設定すると、リクエスト間で continuation_token が自動的に追跡され、単一のレスポンスまたはストリームが返されます。直接 REST 呼び出しの場合は、同じプロンプトを使用して、次のリクエストで各 CONTINUATION レスポンスから continuation_token を渡します。

コードサンプル、SDK バージョンの要件、実装ルールについては、Gemini 4 Argon のデベロッパー ガイドの長いデコードをご覧ください。

思考レベル

thinking_level を使用して、モデルが回答する前に推論する量を制御します。Gemini 4 Argon は、LOW、MEDIUM（gemini-4-argon のデフォルト）、HIGH（gemini-4-argon-cyber-permissive のデフォルト）をサポートしています。

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="gemini-4-argon",
    contents="Design a lock-free ring buffer in Rust for multi-producer, single-consumer telemetry ingestion.",
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(
            thinking_level=types.ThinkingLevel.HIGH,
        ),
    ),
)
print(response.text)

暗黙的なコンテキスト キャッシュ

Gemini 4 Argon は、6,144 個以上のトークンの共有プロンプト接頭辞の暗黙的キャッシュ保存をサポートしています。永続キャッシュ保存はデフォルトで有効になっています。このメリットを活かすには、コード リポジトリや長いドキュメントなどの静的コンテンツをプロンプトの先頭に配置します。

エージェント型動画理解

エージェント型動画理解が一般提供されました。デフォルトではオフになっています。アップロードされた動画では media_processing="static" が使用されます。有効にするには、media_processing を "agentic" に設定します。

サンプリング パラメータ

Gemini 4 Argon は、最近の Gemini 3 モデルと同様に、temperature、top_p、top_k のカスタム値を無視します。出力を制御するには、thinking_level と構造化された出力（response_schema）を使用します。

Gemini 3.1 Pro から移行する

gemini-3.1-pro-preview から gemini-4-argon に移行することをおすすめします。Gemini 4 Argon では、次の動作が異なります。

地域 Gemini 3.1 Pro Gemini 4 Argon 手順
コンテキスト ウィンドウと出力の上限 入力（100 万）と出力（65,535）の上限を分離 入力、思考、出力で共有される 1,048,576 トークンのウィンドウ。65,536 トークンのデフォルトの単一リクエスト出力上限（非ストリーミングの直接 HTTP リクエストの場合は 32,768 トークン）。長いデコードを使用して最大 1,048,576 トークンまで拡張可能 予算の入力と出力をまとめて行います。最新の Google Gen AI SDK にアップグレードし、単一リクエストの上限を超える出力に対して max_output_tokens を 65,536 より大きく設定します（または、カスタム GenerateContent ループで continuation_token を使用します）。
thinking_budget 思考レベルにマッピングされている HTTP 400 エラーを返す thinking_level を使用してください。
thinking_level="MINIMAL" サポート対象 HTTP 400 エラーを返します。 LOW を使用してください。
コンテキスト キャッシュの明示的なキャッシュ保存 サポート対象 非対応 cached_content 参照を削除し、プロンプトの先頭に静的コンテンツ（6,144 トークン以上）を配置します。
トークンの課金 トークンのサブセットが課金される モデルが処理するすべてのトークン（思考トークン、内部ツールのシステム指示、グラウンディングを使用する際の関数宣言など）が課金対象となります。Google 検索によるグラウンディングは、引き続きクエリごとに課金されます。 費用見積もりを確認します。

移行するには:

  1. モデル ID を gemini-4-argon に変更し、最新の Google Gen AI SDK（Python の場合は google-genai >= 2.30.1）にアップグレードします。
  2. 共有の 1,048,576 トークンのコンテキスト ウィンドウと、65,536 トークン（または 32,768 トークンの非ストリーミング ダイレクト HTTP）の単一リクエスト出力上限を考慮します（または、GenerateContent でより大きな出力用に長いデコードを構成します）。
  3. thinking_budget と thinking_level="MINIMAL" を、LOW、MEDIUM、または HIGH に設定された thinking_level に置き換えます。
  4. 明示的な cached_content 参照を削除します。
  5. 効果のない temperature、top_p、top_k を削除しました。

Gemini 4 Argon Cyber Permissive

Gemini 4 Argon Cyber Permissive は、防御的なサイバーセキュリティのユースケース向けの Gemini 4 Argon のバージョンで、許可リストの背後で利用できます。違いとアクセスについては、Gemini 4 Argon Cyber Permissive をご覧ください。

次のステップ