# Gemini 2.5 Pro veraltet: was sich am 1. Dezember 2026 ändert

> Am 1. Dezember 2026 schickt Google jede Anfrage an gemini-2.5-pro zu gemini-3.8-flash und rechnet sie zu 3.8-Flash-Preisen ab. Was bricht und was Sie ändern.

- Canonical HTML: https://omniakey.com/de/blog/gemini-2-5-pro-deprecated-migration-guide
- Markdown: https://omniakey.com/de/blog/gemini-2-5-pro-deprecated-migration-guide.md
- Published: 2026-11-04 (updated 2026-11-04)
- Author: Kiki, COO at OmniaKey
- Language: de
- Category: Guide
- Reading time: 8 min
- All posts: https://omniakey.com/blog/llms.txt

---

Am 1. Dezember 2026 schickt Google jede Anfrage an [Gemini 2.5 Pro](https://omniakey.com/de/gemini-2-5-pro) an [Gemini 3.8 Flash](https://omniakey.com/de/gemini-3-8-flash) und rechnet sie zu 3.8-Flash-Preisen ab: $0.75 pro Million Eingabetoken und $3.75 pro Million Ausgabetoken bis zum 31. Dezember 2026 (Googles Seite zu abgekündigten Modellen, geprüft am 4. November 2026). Am Stichtag laufen die Aufrufe weiter durch. Anfragekörper, die für das alte Modell geschrieben wurden, nicht, und die meisten Korrekturen sind klein.

Drei Änderungen decken den größten Teil der Arbeit ab:

- den Modellnamen auf `gemini-3.8-flash` umstellen;
- `thinking_budget` durch `thinking_level` ersetzen;
- `temperature`, `top_p`, `top_k`, `candidate_count` und vorbelegte model-Turns entfernen.

Die anderen drei Schritte betreffen den Zustand über mehrere Turns, Funktionsaufrufe und das SDK. Jeder Schritt bekommt unten eine Zahl, dazu das, was Sie sehen, wenn Sie ihn auslassen.

## Was passiert am 1. Dezember?

Das Datum stammt aus Googles Versionshinweisen, nicht von einer Countdown-Seite. Der Eintrag vom 2. November 2026 markiert `gemini-2.5-pro` als veraltet und schreibt, dass alle API-Anfragen automatisch zu `gemini-3.8-flash` gehen und zu Gemini-3.8-Flash-Preisen abgerechnet werden (Googles Versionshinweise, geprüft am 4. November 2026).

Die Tabelle der abgekündigten Modelle ergänzt die Daten drumherum: veröffentlicht am 17. Juni 2025, Abschaltung am 1. Dezember 2026, Nachfolger `gemini-3.8-flash` (geprüft am 4. November 2026). Die Modellseite ist enger: Der API-Zugang ist auf bestehende Nutzer begrenzt, die das Modell aktiv verwendet haben, und gilt nur bis zum 1. Dezember 2026. In der Auswahl von AI Studio fehlt das Modell bereits.

Ein Detail lohnt zwei Lesedurchgänge. Dieselbe Tabellenzeile nennt den 1. Dezember 2026 als Abschaltdatum und verspricht zugleich die automatische Weiterleitung an 3.8 Flash. Ob eine weitergeleitete Anfrage in der Antwort `gemini-2.5-pro` oder `gemini-3.8-flash` meldet, sagt Google nicht. Notieren Sie die Modell-ID, die am ersten Tag zurückkommt, im Log.

Was auch immer die Antwort nennt, der Nachfolger ist stabil: `gemini-3.8-flash` ist am 2. September 2026 erschienen, hat eine einzige stabile Versions-ID und kein angekündigtes Abschaltdatum (Googles Seite zu abgekündigten Modellen, geprüft am 4. November 2026).

## Was sich für Code und Rechnung ändert

Die Regel für bestehende Nutzer gilt schon jetzt, vor dem 1. Dezember: Die Modellseite von 2.5 Pro schreibt, dass der API-Zugang auf bestehende Nutzer begrenzt ist, die das Modell aktiv verwendet haben, und nur bis zum 1. Dezember 2026 gilt (geprüft am 4. November 2026). Testen Sie mit dem Schlüssel, den Ihr Team tatsächlich einsetzt, bevor Sie den Rest planen.

Die beiden Modelle liegen näher beieinander, als diese Regel vermuten lässt. Beide nehmen 1.048.576 Eingabetoken auf und geben bis zu 65.536 zurück, beide lesen Text, Bilder, Video, Audio und PDF, und beide geben Text zurück (Googles Modellseiten, geprüft am 4. November 2026). Unterschiede zeigen sich am Rand: Die Seite von 3.8 Flash führt computer use als unterstützt, die Seite von 2.5 Pro hat keine Zeile zu computer use. Audiogenerierung, Bildgenerierung und Live API sind bei beiden als nicht unterstützt markiert.

Dann die Rechnung. Ab dem 1. Dezember zahlen Sie für dieselbe Anfrage 3.8-Flash-Preise. Davor behält 2.5 Pro seinen eigenen Preis und seine Stufe bis 200.000 Token.

## Was beim Umstieg auf 3.8 Flash bricht

Sechs Anfrageformen ändern ihr Verhalten, und Funktionsaufrufe brauchen den genauesten Durchgang. Googles Checkliste für den Umstieg auf 3.8 Flash nennt jede Änderung (geprüft am 4. November 2026).

|Was Sie senden|Was passiert|Was zu ändern ist|
|-|-|-|
|`thinking_budget`|in der 3.8-Anfrage ersetzt|`thinking_level` senden|
|`thinking_level: "minimal"`|liefert einen Fehler|`low`, `medium` oder `high` verwenden|
|`temperature`, `top_p`, `top_k`|heute ignoriert, HTTP 400 in künftigen Generationen|streichen|
|`candidate_count`|ab Gemini 3 nicht unterstützt|ein Kandidat pro Aufruf|
|ein letzter Turn mit `role: "model"`|HTTP 400|die Regel in `system_instruction` verschieben|
|`FunctionResponse` ohne `call_id` und `name`|`Malformed_Function_Call`|beide Felder ergänzen|

Die Sampling-Parameter sind der leise Ausfall. Googles Hinweise zu 3.6 sagen, `temperature`, `top_p` und `top_k` seien veraltet und würden heute ignoriert, und in künftigen Modellgenerationen führe das Mitsenden zu HTTP 400 (geprüft am 4. November 2026). Für einen abgestimmten Prompt ist Ignorieren schlimmer als Ablehnen: Die Determinismus-Einstellungen tun nichts mehr, und kein Fehler sagt es Ihnen.

Laut ist die Vorbelegung. Eine Anfrage, deren letzter nicht leerer Turn ein model-Turn ist, liefert HTTP 400, und die Lösung heißt `system_instruction` oder strukturierte Ausgaben (Googles Hinweise zu 3.6, geprüft am 4. November 2026). Gespräche über mehrere Turns sollten `previous_interaction_id` tragen statt eines neu zusammengebauten Verlaufs mit vorbelegtem letzten Turn.

Für Funktionsaufrufe gehören multimodale Anhänge in den Antwortkörper, Anweisungen im Text werden mit `\n\n` getrennt, und bei `Malformed_Function_Call` rund um Text vor dem Tool hilft Googles Workaround. Beim alten `generateContent`-Aufruf braucht jede `FunctionResponse` `call_id` und `name`.

Thought Signatures sind der sechste Punkt, und sie zählen, wenn Ihr SDK älter ist als das Modell. Googles Checkliste verweist für SDK-Updates und das Bewahren der Signaturen auf die Seite zu Thought Signatures.

## Die sechs Änderungen Schritt für Schritt

Arbeiten Sie in dieser Reihenfolge. Die ersten beiden betreffen jede Anfrage, die übrigen einzelne Funktionen.

1. **Modellnamen ändern.** Senden Sie `gemini-3.8-flash` statt `gemini-2.5-pro`, in der Konfiguration und nicht im Retry-Helfer, damit im Log die ID steht, die Sie aufrufen wollten.
2. **Thinking-Budget ersetzen.** Aus `thinking_budget` wird `thinking_level` mit `low`, `medium` oder `high`. `medium` ist der Standard, `minimal` liefert einen Fehler.
3. **Sampling-Parameter und Vorbelegung streichen.** `temperature`, `top_p`, `top_k`, `candidate_count` und ein abschließender model-Turn entfallen.
4. **Zustand über mehrere Turns verschieben.** Einheitlich `previous_interaction_id` auf der Serverseite verwenden.
5. **Funktionsaufrufe prüfen.** Anhänge in den Antwortkörper, `\n\n` zwischen Anweisungen im Text, `call_id` und `name` an jeder `FunctionResponse`.
6. **SDK aktualisieren und Thought Signatures behalten.** Die Checkliste zu 3.8 verlinkt dafür Googles Seite zu Thought Signatures.

Der Diff der Anfrage passt in einen Block. Vorher:

```json
{
  "model": "gemini-2.5-pro",
  "contents": [{"role": "user", "parts": [{"text": "Summarize the attached invoice."}]}],
  "generation_config": {
    "thinking_budget": 8192,
    "temperature": 0.7,
    "top_p": 0.9
  }
}
```

Nachher:

```json
{
  "model": "gemini-3.8-flash",
  "contents": [{"role": "user", "parts": [{"text": "Summarize the attached invoice."}]}],
  "generation_config": {
    "thinking_level": "medium"
  }
}
```

Schicken Sie vor dem 1. Dezember eine echte Anfrage an `gemini-3.8-flash` und notieren Sie die Modell-ID aus der Antwort.

Wenn Sie `gemini-3.8-flash` während der Umstellung anders aufrufen wollen, listet die [Modellseite von Gemini 3.8 Flash](https://omniakey.com/de/gemini-3-8-flash) die ID, den Kontext von 1M und die drei Thinking-Stufen. Die aktuellen Tarife beider Modelle stehen auf der [Preisseite](https://omniakey.com/de/pricing).

## Der Preisunterschied

In der kostenpflichtigen Standardstufe kostet 3.8 Flash bis zum 31. Dezember 2026 weniger als die Hälfte von 2.5 Pro bei der Ausgabe und 40 % weniger bei der Eingabe (Googles Preisseite, geprüft am 4. November 2026).

|Modell|Eingabe pro 1M|Ausgabe pro 1M|
|-|-|-|
|`gemini-2.5-pro`, bis 200k|$1.25|$10.00|
|`gemini-2.5-pro`, über 200k|$2.50|$15.00|
|`gemini-3.8-flash`, bis 31. Dez. 2026|$0.75|$3.75|
|`gemini-3.8-flash`, ab 1. Jan. 2027|$1.50|$7.50|

Eine Anfrage mit 100.000 Eingabetoken und 20.000 Ausgabetoken macht den Abstand konkret. Bei 2.5 Pro kostet sie $0.125 + $0.20 = $0.325. Bei 3.8 Flash kostet sie bis zum 31. Dezember 2026 $0.075 + $0.075 = $0.15 und ab dem 1. Januar 2027 $0.15 + $0.15 = $0.30.

Lesen Sie die Zeile für 2027, bevor Sie feiern. Die Eingabe steigt 20 % über die $1.25 von 2.5 Pro, die Ausgabe bleibt 25 % unter den $10.00 von 2.5 Pro. Eine Anfrage mit viel Eingabe kostet im nächsten Jahr mehr als heute mit 2.5 Pro.

Die Batch-Preise behalten die Form: 2.5 Pro berechnet $0.625 für die Eingabe und $5.00 für die Ausgabe bis 200k Token, 3.8 Flash berechnet $0.375 und $1.875 bis zum 31. Dezember 2026 (Googles Preisseite, geprüft am 4. November 2026).

Die vollständige Preistabelle mit Cache, Priority und den Zahlen für 2027 steht im [Preisleitfaden zu Gemini 3.8 Flash](https://omniakey.com/de/blog/gemini-3-8-flash-api-pricing).

## 2.5 Flash und 2.5 Flash-Lite

2.5 Flash trifft dasselbe Datum am 1. Dezember, 2.5 Flash-Lite nicht.

|Modell|Abschaltung|Nachfolger|
|-|-|-|
|`gemini-2.5-flash`|1. Dezember 2026|`gemini-3.5-flash-lite`|
|`gemini-2.5-flash-lite`|keine angekündigt|bleibt verfügbar|

Googles Seite zu abgekündigten Modellen (geprüft am 4. November 2026) stellt `gemini-2.5-flash` unter dieselben Bedingungen wie 2.5 Pro: veröffentlicht am 17. Juni 2025, Anfragen gehen ab dem 1. Dezember 2026 an `gemini-3.5-flash-lite`, die Abrechnung wechselt auf 3.5-Flash-Lite-Preise. `gemini-2.5-flash-lite` ist nicht veraltet und bleibt bis auf Weiteres verfügbar.

Zwei Audio-IDs brauchen einen eigenen Kalendereintrag. `gemini-2.5-pro-preview-tts` und `gemini-2.5-flash-preview-tts` werden am 17. November 2026 abgeschaltet, ersetzt durch `gemini-3.8-flash-tts` oder `gemini-3.8-flash-lite-tts`.

Die älteren festen 2.5-Pro-Previews sind schon weg. `gemini-2.5-pro-preview-03-25`, `-05-06` und `-06-05` haben ein Abschaltdatum vom 2. Dezember 2025. Eine Konfiguration, die noch einen davon nennt, scheitert heute.

## Häufige Fragen

### Ist Gemini 2.5 Pro veraltet?

Ja. Googles Versionshinweise vom 2. November 2026 markieren `gemini-2.5-pro` als veraltet, und die Seite zu abgekündigten Modellen setzt den 1. Dezember 2026 als Tag, an dem jede API-Anfrage zu `gemini-3.8-flash` wandert (geprüft am 4. November 2026). In der Auswahl von AI Studio fehlt das Modell bereits.

### Was passiert am 1. Dezember 2026 mit meinen Aufrufen?

Sie liefern weiter Antworten. Google sagt, Anfragen an `gemini-2.5-pro` gehen automatisch zu `gemini-3.8-flash` und werden zu 3.8-Flash-Preisen abgerechnet. Dieselbe Tabelle nennt den 1. Dezember 2026 auch als Abschaltdatum, und welche Modell-ID die Antwort meldet, sagt Google nicht. Notieren Sie sie am ersten Tag im Log.

### Ist Gemini 2.5 Pro noch in AI Studio?

Nein. Google hat `gemini-2.5-pro` aus der Auswahl von AI Studio entfernt und begrenzt den API-Zugang auf bestehende Nutzer, die das Modell aktiv verwendet haben, bis zum 1. Dezember 2026 (Googles Seiten zu abgekündigten Modellen und zum Modell, geprüft am 4. November 2026).

### Bricht mein Code, wenn ich nichts ändere?

Rechnen Sie mit Fehlern, wo 3.8 Flash ein altes Feld ablehnt: `thinking_level: "minimal"`, `candidate_count`, ein letzter model-Turn und `FunctionResponse`-Objekte ohne `call_id` und `name`. `thinking_budget` muss zu `thinking_level` werden, und `temperature`, `top_p` und `top_k` werden schon heute ignoriert. Googles Migrationsleitfaden listet jede Änderung, und eine Anfrage, die mit einem nicht leeren model-Turn endet, liefert bereits HTTP 400.

### Wie viel günstiger ist Gemini 3.8 Flash?

Bis zum 31. Dezember 2026 ist es 40 % günstiger bei der Eingabe und 62,5 % günstiger bei der Ausgabe als 2.5 Pro unter 200k Token: $0.75 gegen $1.25 und $3.75 gegen $10.00 pro Million. Ab dem 1. Januar 2027 kostet die Eingabe 20 % mehr als bei 2.5 Pro, die Ausgabe 25 % weniger.

## Geprüfte Quellen

- [Google Gemini API: abgekündigte Modelle](https://ai.google.dev/gemini-api/docs/deprecations)
- [Google Gemini API: Versionshinweise](https://ai.google.dev/gemini-api/docs/changelog)
- [Umstieg auf Gemini 3.8 Flash](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.8)
- [Gemini 3.6: API-Änderungen und Parameter](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.6)
- [Modellseite Gemini 2.5 Pro](https://ai.google.dev/gemini-api/docs/models/gemini-2.5-pro)
- [Modellseite Gemini 3.8 Flash](https://ai.google.dev/gemini-api/docs/models/gemini-3.8-flash)
- [Preise der Gemini API](https://ai.google.dev/gemini-api/docs/pricing)
