Entwicklerleitfaden für Gemini 3.8 Flash

Gemini 3.8 Flash ist unser bisher intelligentestes Modell für die tägliche Arbeit. Es bietet im Vergleich zu 3.7 Flash erhebliche Verbesserungen in den Bereichen Softwareentwicklung, agentische Aufgaben und kritische, mehrstufige Problemlösung in spezialisierten Bereichen. 3.8 Flash bietet erhebliche Verbesserungen gegenüber 3.7 Flash und erreicht oft die Leistung von teureren Frontier-Modellen.

In diesem Dokument erfahren Sie, was neu bei 3.8 Flash ist, wie es in die Gemini-Modellfamilie passt, wie Sie zu 3.8 Flash migrieren und wie Sie 3.8 Flash verwenden.

Wie passt es in die Gemini-Familie?

Die Gemini Flash-Modelle sind die primären agentischen Arbeitstiere der Gemini 3-Familie. Sie schließen die Lücke zwischen den Gemini Pro-Modellen mit tiefem logischem Denken und den Gemini Flash-Lite-Modellen mit hohem Durchsatz und bieten gleichzeitig eine hohe Token-Effizienz und mehrstufige multimodale Verarbeitung.

Im Vergleich zu 3.7 Flash bietet 3.8 Flash eine höhere Genauigkeit und zuverlässigere Leistung, verbraucht aber mehr Tokens. 3.8 Flash bietet jedoch auch eine Aufwandssteuerung über Denkebenen, mit denen Sie diesen Verbrauch modulieren können. Auf der mittleren Thinking-Stufe können Sie komplexe agentische Aufgaben lösen und gleichzeitig den Tokenverbrauch reduzieren. Sie können auch niedrigere Denkebenen für latenzempfindliche Aufgaben verwenden, um den Rechenaufwand vollständig zu vermeiden. Wenn Sie die Recheneffizienz optimieren möchten, sollten Sie 3.7 Flash verwenden.

Modellspezifikationen und -vergleiche

In der folgenden Tabelle werden einige der Spezifikationen von 3.8 Flash, 3.7 Flash und 3.1 Pro verglichen:

Gemini 3.8 Flash Gemini 3.7 Flash Gemini 3.1 Pro
Modell-ID gemini-3.8-flash gemini-3.7-flash gemini-3.1-pro-preview
Startphase AV GA Vorschau
Eingabetypen Text, Bild, Audio, Video Text, Bild, Audio, Video Text, Bild, Audio, Video
Ausgabetyp(en) Text Text Text
Verlaufszeitraum 1.048.576 1.048.576 1.048.576
Maximale Länge des Ausgabetokens 65.536 65.536 65.536
Unterstützte Regionen Global, Multiregional Global, Multiregional Global
Unterstützte Denkaufwände LOW, MEDIUM, HIGH
(Standard: MEDIUM) 		LOW, MEDIUM, HIGH
(Standard: MEDIUM) 		LOW, MEDIUM, HIGH
(Standard: HIGH)
Schwerpunkt Agentische Workflows, Programmierung, interaktives Videoverständnis Allgemeine agentische Workflows, mehrstufige Orchestrierung, Programmierung Aufgaben mit komplexen logischen Schlussfolgerungen und hoher Komplexität

Eine vollständige Liste der unterstützten Funktionen, Tools und Nutzungsoptionen finden Sie auf der Seite zum 3.8 Flash-Modell.

Was ist neu in Gemini 3.8 Flash?

In der folgenden Tabelle werden die Standard-Benchmarks für die Entwicklerbewertung zwischen Gemini 3.8 Flash und 3.7 Flash verglichen:

Benchmark für die Bewertung 3.8 Flash 3.7 Flash
Terminal-bench 2.1 90,8 % 81,6 %
SWE-Bench Pro 61,6 % 60,4 %
SWE-Atlas 51,9 % 48,0 %
τ³-bench Banking 38,1 % 30,9 %
CharXiv (multimodal) 86,2 % 84,5 %
GDP.pdf 35,0 % 34,0 %
Humanity's Last Exam (HLE) 45,4 % 45,7 %

Kurzanleitung

Bevor Sie beginnen, müssen Sie sich bei der Agent Platform mit Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) oder einem API-Schlüssel authentifizieren. Weitere Informationen finden Sie unter Erste Schritte mit der Gemini Enterprise Agent Platform.

Ersetzen Sie in den folgenden Codeblöcken PROJECT_ID durch Ihre Projekt-ID.

Installation

Achten Sie darauf, dass Sie das neueste google-genai SDK verwenden:

pip install --upgrade google-genai

Einfache Anfrage

Python

from google import genai

client = genai.Client(enterprise=True, project="PROJECT_ID", location="global")

response = client.models.generate_content(
  model="gemini-3.8-flash",
  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-3.8-flash:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "Why is the sky blue?" },
  },
}'

Obligatorische API-Regeln und Verhaltenskonventionen

Gemini 3.8 Flash setzt die folgenden Standard-API-Konventionen der Gemini 3-Familie strikt durch:

  • Verworfene Sampling-Parameter (temperature, top_k, top_p): Diese Parameter werden vom Backend ignoriert. Stattdessen können Sie den Determinismus mit thinking_level (LOW, MEDIUM, HIGH) und response_schema oder json_schema steuern.
  • Nicht unterstützte Parameter (frequency_penalty, presence_penalty, candidate_count): Wenn Sie frequency_penalty, presence_penalty oder candidate_count übergeben, wird ein aktiver API-Fehler ausgegeben. Entfernen Sie sie aus dem alten Clientcode.

  • Strikte Regeln für Funktionsaufrufe: Ein FunctionResponse-Turn muss genau mit dem id, dem name und der Ausführungsanzahl des vorherigen FunctionCall übereinstimmen.

    • Multimodale Assets: Platzieren Sie multimodale Assets immer in der Antwortnutzlast.
    • Formatierung und Text vor dem Tool: Formatieren Sie Inline-Anweisungen mit \n\n. Wenn Malformed_Function_Call-Fehler im Zusammenhang mit Text vor dem Tool auftreten, entfernen Sie führende Kommentare vor Toolaufrufen.

    • Wenn Sie vor einem Toolaufruf Zwischennotizen oder Statusaktualisierungen übergeben möchten, verpacken Sie diese in einen dedizierten update()-Funktionsaufruf, anstatt rohes XML oder Text auszugeben:

      {
  "name": "update",
  "description": "Update working notes before tool execution",
  "parameters": {
    "type": "OBJECT",
    "properties": {
      "previous_step": {"type": "STRING"},
      "plan": {"type": "STRING"},
      "next_step": {"type": "STRING"}
    },
    "required": ["previous_step", "plan", "next_step"]
  }
}

  • Validierung der Chatsequenz:

    • Verlaufsnutzlasten dürfen nicht mit einem Rollenwechsel „model“ enden.
    • Vorausgefüllte Modellantworten werden nicht unterstützt und müssen beim Upgrade entfernt werden.
    • Leere Turns im Unterhaltungsverlauf werden automatisch gelöscht oder führen zu Validierungsfehlern.

3.8 Flash von 3.7 Flash oder 3.6 Flash

So migrieren Sie von 3.7 Flash oder 3.6 Flash zu 3.8 Flash:

  1. Modell-ID aktualisieren: Ändern Sie den Modellstring in Ihren API-Aufrufen in gemini-3.8-flash.
  2. Parameter für das Reasoning-Budget ersetzen: Ersetzen Sie die Ganzzahlkonfigurationen thinking_budget durch das String-Enum thinking_level, das auf einen der folgenden Werte festgelegt ist:
    • HIGH: Empfohlen für dichte visuelle QA, Bewegungserkennung im Bruchteil einer Sekunde (Sport, Bearbeitung) oder mehrstufige Problemlösung bei Videos mit einer Länge von mehr als 60 Minuten.
    • MEDIUM: Das Standard-Thinking-Level. Diese Stufe bietet ein optimales Gleichgewicht für allgemeine Fragen und Antworten zu Videos, Zusammenfassungen von Vorlesungen und das Abrufen von Clips.
    • LOW: Empfohlen für Aufgaben wie schnelle, transkriptorientierte Suchen oder grundlegende Metadatenextraktion.
  3. Eingestellte und nicht unterstützte Parameter entfernen:
    • Entfernen Sie temperature, top_p und top_k.
    • Entfernen Sie candidate_count, frequency_penalty und presence_penalty.
    • Entfernen Sie alle vorausgefüllten Modellantworten aus dem Unterhaltungsverlauf.

Zusammenfassende Checkliste für Entwickler

Zusätzliche Ressourcen