開始使用 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.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 個詞元，扣除輸入內容的詞元後即為上限。 根據預設，單一同步要求最多可產生 65,536 個輸出詞元 (非串流直接 HTTP 要求則為 32,768 個詞元)。

長解碼

如果單一回合需要超過 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 會忽略 temperature、top_p 和 top_k 的自訂值，就像近期的 Gemini 3 模型一樣。如要控管輸出內容，請使用 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 個 (非串流直接 HTTP 則為 32,768 個)。您也可以在 GenerateContent 設定長解碼，提高輸出上限。
3. 將 thinking_budget 和 thinking_level="MINIMAL" 替換為 thinking_level，並設為 LOW、MEDIUM 或 HIGH。
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 模型頁面。
• 進一步瞭解思考。