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 Google Gen AI SDK をインストールする

最新の google-genai SDK（Python の場合は >= 2.30.1、JavaScript の場合は @google/genai >= 2.29.1）にアップグレードします。

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

環境変数を設定する

GOOGLE_CLOUD_PROJECT は、実際の Cloud de Confiance by S3NS プロジェクト 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

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

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-4-argon",
    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-4-argon:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "How does AI work?" }
  }
}'

Gemini 4 の新機能

入力トークンと出力トークンの統合上限

Gemini 4 Argon には、入力トークンと出力トークンの両方を含む 1,048,576 トークンの統合上限があります（出力には、思考、関数呼び出し、最終レスポンスが含まれます）。出力には、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、JavaScript の場合は @google/genai >= 2.29.1）では、max_output_tokens を 65,536 より大きい値（ストリーミング以外のリクエストの場合は 32,768 より大きい値）に設定すると、リクエスト全体で 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 では、次の動作が異なります。

移行手順は次のとおりです。

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 をご覧ください。

次のステップ

• Gemini 4 Argon の概要ノートブック チュートリアルを試す。
• Gemini 4 Argon のデベロッパー ガイドを読む。
• 仕様、サポートされている機能、ロケーションについては、Gemini 4 Argon モデルのページをご覧ください。
• 詳しくは、思考モードをご覧ください。