Das erste Gemini 4-Modell ist Gemini 4 Argon (gemini-4-argon), das Frontier-Modell von Google, das sich durch tiefgreifende Arbeit bei komplexen, realen Aufgaben in verschiedenen Bereichen wie Programmierung, Finanzen, Recht, Cybersicherheit und Wissenschaft auszeichnet.
In diesem Leitfaden erfahren Sie, wie Sie Ihre erste Gemini 4-Anfrage stellen, was in Gemini 4 neu ist und was sich bei der Migration von Gemini 3.1 Pro ändert. Modellspezifische Informationen finden Sie im Entwicklerhandbuch für Gemini 4 Argon.
Kurzanleitung
Bevor Sie beginnen, müssen Sie sich mit einem API-Schlüssel oder Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) bei der Gemini Enterprise Agent Platform authentifizieren. Weitere Informationen finden Sie unter Authentifizierungsmethoden.
Google Gen AI SDK installieren
Führen Sie ein Upgrade auf das neueste google-genai SDK durch (>= 2.30.1 für Python, @google/genai >= 2.29.1 für JavaScript):
pip install --upgrade "google-genai>=2.30.1"
Umgebungsvariablen festlegen
Ersetzen Sie dabei GOOGLE_CLOUD_PROJECT durch die ID Ihres Projekts in Cloud de Confiance by S3NS .
Gemini 4 Argon ist am Endpunkt global und in den Multiregionen us und eu verfügbar:
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True
Erste Anfrage senden
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?" }
}
}'
Neu bei Gemini 4
Einheitliches Limit für Eingabe- und Ausgabetokens
Gemini 4 Argon hat ein einheitliches Limit von 1.048.576 Tokens, das sowohl Eingabe- als auch Ausgabetokens umfasst. Die Ausgabe umfasst dabei Thinking, Funktionsaufrufe und die endgültige Antwort. Die Ausgabe kann bis zu 1.048.576 Tokens abzüglich Ihrer Eingabetokens umfassen. Standardmäßig generiert eine einzelne synchrone Anfrage bis zu 65.536 Ausgabetokens (oder 32.768 Tokens für nicht-streamingbasierte direkte HTTP-Anfragen).
Lange Decodierungen
Wenn für eine einzelne Runde mehr als 65.536 Ausgabetokens (oder 32.768 für nicht-streamingbasierte direkte HTTP-Aufrufe) erforderlich sind, z. B. für formale Beweise, komplexe mathematische oder wissenschaftliche Probleme oder die Codegenerierung für mehrere Dateien, unterstützt Gemini 4 Argon lange Decodierungen mit bis zu 1.048.576 Tokens (abzüglich Ihrer Eingabetokens) auf GenerateContent (generateContent und streamGenerateContent). Mit dem neuesten Google Gen AI SDK (google-genai >= 2.30.1 für Python, @google/genai >=
2.29.1 für JavaScript) wird bei der Einstellung von max_output_tokens auf einen Wert größer als 65.536 (oder größer als 32.768 für nicht-streamingbasierte Anfragen) automatisch continuation_token über Anfragen hinweg verwendet, um eine einzelne Antwort oder einen einzelnen Stream zurückzugeben. Bei direkten REST-Aufrufen übergeben Sie die continuation_token aus jeder CONTINUATION-Antwort bei der nächsten Anfrage mit demselben Prompt.
Codebeispiele, Anforderungen an die SDK-Version und Implementierungsregeln finden Sie im Entwicklerhandbuch für Gemini 4 Argon unter Lange Decodierungen.
Denkaufwand
Mit thinking_level können Sie festlegen, wie viel das Modell vor der Beantwortung nachdenken soll.
Gemini 4 Argon unterstützt LOW, MEDIUM (Standardeinstellung für gemini-4-argon) und HIGH (Standardeinstellung für 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)
Implizites Kontext-Caching
Gemini 4 Argon unterstützt implizites Caching für gemeinsame Prompt-Präfixe mit mindestens 6.144 Tokens. Dauerhaftes Caching ist standardmäßig aktiviert. Um davon zu profitieren, platzieren Sie statische Inhalte wie ein Code-Repository oder lange Dokumente am Anfang Ihres Prompts.
Agentisches Videoverständnis
Agentisches Videoverständnis ist allgemein verfügbar. Sie ist standardmäßig deaktiviert. Hochgeladene Videos verwenden media_processing="static". Setzen Sie media_processing auf "agentic", um die Funktion zu aktivieren.
Parameter für die Stichprobenerhebung
Gemini 4 Argon ignoriert benutzerdefinierte Werte für temperature, top_p und top_k, wie es auch bei neueren Gemini 3-Modellen der Fall ist. Verwenden Sie thinking_level und strukturierte Ausgabe (response_schema), um die Ausgabe zu steuern.
Von Gemini 3.1 Pro migrieren
Wir empfehlen die Migration von gemini-3.1-pro-preview zu gemini-4-argon. Das folgende Verhalten ist in Gemini 4 Argon anders:
| Gebiet | Gemini 3.1. Pro | Gemini 4 Argon | Was muss ich tun? |
|---|---|---|---|
| Limits für Eingabe- und Ausgabetokens | Separate Limits für Eingabe (1.048.576) und Ausgabe (65.536) | Einheitliches Limit von 1.048.576 Tokens für Eingabe und Ausgabe (wobei die Ausgabe Thinking, Funktionsaufrufe und die endgültige Antwort umfasst); Standardlimit von 65.536 Tokens für die Ausgabe einer einzelnen Anfrage (32.768 Tokens für nicht-streamingbasierte direkte HTTP-Anfragen), erweiterbar auf bis zu 1.048.576 Tokens mit langen Decodierungen | Budgeteingabe und -ausgabe zusammen. Führen Sie ein Upgrade auf das neueste Google Gen AI SDK durch und legen Sie max_output_tokens auf einen Wert größer als 65.536 fest (oder verwenden Sie continuation_token in benutzerdefinierten GenerateContent-Schleifen) für Ausgaben,die das Limit für einzelne Anfragen überschreiten. |
thinking_budget |
Einem Denkaufwand zugeordnet | Gibt einen HTTP-Fehler 400 zurück |
Verwenden Sie thinking_level. |
thinking_level="MINIMAL" |
Unterstützt | Gibt einen HTTP-Fehler 400 zurück |
Verwenden Sie LOW. |
| Explizites Kontext-Caching | Unterstützt | Nicht unterstützt | Entfernen Sie cached_content-Verweise und platzieren Sie statische Inhalte (6.144 Tokens oder mehr) am Anfang Ihrer Prompts. |
| Tokenabrechnung | Ein Teil der Tokens wird abgerechnet | Jedes vom Modell verarbeitete Token wird in Rechnung gestellt, einschließlich Thinking-Tokens und interner Toolsystemanweisungen und Funktionsdeklarationen bei der Verwendung von Grounding. Die Fundierung mit der Google Suche wird weiterhin pro Abfrage abgerechnet. | Prüfen Sie Ihre Kostenschätzungen. |
So nimmst du eine Migration vor:
- Ändern Sie die Modell-ID in
gemini-4-argonund führen Sie ein Upgrade auf das neueste Google Gen AI SDK (google-genai >= 2.30.1für Python) durch. - Berücksichtigen Sie das einheitliche Limit von 1.048.576 Tokens für Eingabe und Ausgabe sowie die Obergrenze von 65.536 Tokens (oder 32.768 Tokens für direkte HTTP-Anfragen ohne Streaming) für die Ausgabe einer einzelnen Anfrage. Alternativ können Sie lange Decodierungen für größere Ausgaben in
GenerateContentkonfigurieren. - Ersetzen Sie
thinking_budgetundthinking_level="MINIMAL"durchthinking_level, wobeiLOW,MEDIUModerHIGHfestgelegt ist. - Entfernen Sie explizite
cached_content-Verweise. - Entfernen Sie
temperature,top_pundtop_k, da sie keine Auswirkungen haben.
Gemini 4 Argon Cyber Permissive
Gemini 4 Argon Cyber Permissive ist eine Version von Gemini 4 Argon für defensive Cybersicherheits-Anwendungsfälle, die über eine Zulassungsliste verfügbar ist. Informationen zu den Unterschieden und zum Zugriff finden Sie unter Gemini 4 Argon Cyber Permissive.
Nächste Schritte
- Probieren Sie das Notebook-Tutorial Einführung in Gemini 4 Argon aus.
- Lesen Sie den Entwicklerleitfaden zu Gemini 4 Argon.
- Informationen zu Spezifikationen, unterstützten Funktionen und Standorten finden Sie auf der Modellseite für Gemini 4 Argon.
- Weitere Informationen zum Nachdenken