From 1c95caf2129b2a3e390572692594390ea4fcde70 Mon Sep 17 00:00:00 2001 From: adssib <75389300+adssib@users.noreply.github.com> Date: Fri, 20 Nov 2026 21:13:13 -0500 Subject: [PATCH] add google/gemini-models: the Gemini API's model shutdown table Co-Authored-By: Claude Opus 5.5 Signed-off-by: adssib <75389300+adssib@users.noreply.github.com> --- docs/writing-a-plugin.md | 2 +- plugins/notices/google_test.go | 78 ++ plugins/notices/notices.go | 6 + plugins/notices/retire/formats.go | 71 ++ plugins/notices/retire/notices.go | 2 +- plugins/notices/retire/providers.go | 27 +- plugins/notices/retire/retire.go | 88 +- plugins/notices/retire/testdata/README.md | 3 +- .../retire/testdata/gemini-deprecations.md | 1001 +++++++++++++++ plugins/notices/retirements_golden_test.go | 4 +- .../notices/retirements_registered_test.go | 2 +- .../testdata/golden/google-gemini-models.json | 1072 +++++++++++++++++ providers/google-gemini-models.md | 33 + 13 files changed, 2359 insertions(+), 30 deletions(-) create mode 100644 plugins/notices/google_test.go create mode 100644 plugins/notices/retire/formats.go create mode 100644 plugins/notices/retire/testdata/gemini-deprecations.md create mode 100644 plugins/notices/testdata/golden/google-gemini-models.json create mode 100644 providers/google-gemini-models.md diff --git a/docs/writing-a-plugin.md b/docs/writing-a-plugin.md index 73967c6..302e7a9 100644 --- a/docs/writing-a-plugin.md +++ b/docs/writing-a-plugin.md @@ -83,7 +83,7 @@ Write the numbers on the provider page, as `providers/vercel.md` does for its sp | Kind | Reads | Add a source by | |---|---|---| | `plugins/openapi` | An OpenAPI spec per release, diffed with `core/diff/` and turned into events by `core/normalize/` | An `adapter.Adapter` in `plugins/openapi/adapter/` (latest tag, fetch a tag's spec; `Versions` to list every release) and a `plugin.RegisterProvider` block | -| `plugins/notices` | A live page of dated notices: a model provider's deprecations page (a table of date, model, replacement), a vendor's RSS or Atom feed, a vendor's table of whole API version ranges and their support status | A `retire.Page` in `plugins/notices/retire/providers.go`, a `feed.Feed` with a reader for that vendor's entries in `plugins/notices/feed/`, or an `eol.Page` in `plugins/notices/eol/` (`new-plugin` doesn't scaffold this reader yet) | +| `plugins/notices` | A live page of dated notices: a model provider's deprecations page (a table of date, model, replacement: Markdown or Markdoc), a vendor's RSS or Atom feed, a vendor's table of whole API version ranges and their support status | A `retire.Page` in `plugins/notices/retire/providers.go`, a `feed.Feed` with a reader for that vendor's entries in `plugins/notices/feed/`, or an `eol.Page` in `plugins/notices/eol/` (`new-plugin` doesn't scaffold this reader yet) | | `plugins/migrationguide` | A guide that lists what a release removed, at the release's tag: an SDK's migration guide per new major (removed request parameters), or a package's table of removed members (an RST simple table or a Markdown pipe table) | A `sdkguide.Guide` in `plugins/migrationguide/sdkguide/`, or a `members.Guide` in `plugins/migrationguide/members/` | | `plugins/changelog` | A changelog: a `CHANGELOG.md` / `CHANGES.rst` / `HISTORY.rst`, each release's section at its tag (releases from PyPI or npm), or a vendor's machine-readable API changelog in JSON (per day, endpoint and API version, oasdiff change codes), commit by commit | A `changelog.File` with its `TagPrefix`, or a `changelog.Log` | | `plugins/catalog` | A provider's own structured list of what it offers: a command catalog kept as one JSON file per command in its repo, read at each release tag and compared for commands that disappeared entirely | A `catalog.Commands` (repo, directory, release tag pattern); a catalog of another shape is a new reader type in the package | diff --git a/plugins/notices/google_test.go b/plugins/notices/google_test.go new file mode 100644 index 0000000..c8d72f2 --- /dev/null +++ b/plugins/notices/google_test.go @@ -0,0 +1,78 @@ +package notices + +import ( + "os" + "strings" + "testing" + + "github.com/patch-it-dev/patch-it-plugins/core/kit/kittest" + "github.com/patch-it-dev/patch-it-plugins/plugins/notices/retire" +) + +// section is the saved page from start up to end (to the end of the page +// when end is ""), as a page of its own. +func section(t *testing.T, file, start, end string) string { + t.Helper() + b, err := os.ReadFile(file) + if err != nil { + t.Fatal(err) + } + s := string(b) + i := strings.Index(s, start) + if i < 0 { + t.Fatalf("%s: the saved page's shape changed", file) + } + if end == "" { + return s[i:] + } + j := strings.Index(s[i+1:], end) + if j < 0 { + t.Fatalf("%s: the saved page's shape changed", file) + } + return s[i : i+1+j] +} + +// readGoogle is a first read of page, served as content, through the kind. +func readGoogle(t *testing.T, page retire.Page, content string) int { + t.Helper() + f := t.TempDir() + "/page" + if err := os.WriteFile(f, []byte(content), 0o644); err != nil { + t.Fatal(err) + } + saved := kittest.Pages{page.URL: f} + return len(kittest.Page(t, kittest.Env(t, saved), Plugin{Page: page, Archiver: &kittest.Archive{T: t, Pages: saved}})) +} + +// The pinned drop test for the Gemini API page: the Gemini 4 models (no +// shutdown date announced) and the managed agents, whose deprecated table +// has real dates but names agents, not models, next to the two Gemini 3 +// models shut down already. Only those two are events; the agents' table +// renamed to "Model" would give two more, so the header is what keeps it +// out. +func TestGeminiDropsModelsWithNoDateAndAgents(t *testing.T) { + const file = "retire/testdata/gemini-deprecations.md" + current := section(t, file, "## Gemini 4 models", "## Gemini 3 models") + retired := section(t, file, "### Deprecated models {% id=\"gemini-3-deprecated-models\" %}", "## Gemini 2.5 Pro models") + agents := section(t, file, "## Managed agents", "") + if n := readGoogle(t, retire.Gemini, current+retired+agents); n != 2 { + t.Errorf("%d events, want the 2 shut-down Gemini 3 models only", n) + } + if _, err := retire.Parse(retire.Gemini.Format.Pipes([]byte(agents)), retire.Gemini.Keep); err == nil { + t.Error("the agents' tables read as retirements") + } + asModels := strings.ReplaceAll(agents, " * Agent\n", " * Model\n") + if rs, err := retire.Parse(retire.Gemini.Format.Pipes([]byte(asModels)), retire.Gemini.Keep); err != nil || len(rs) != 2 { + t.Errorf("the agents' table with a Model header: %d, %v; the drop proves nothing", len(rs), err) + } +} + +// Google's Gemini dates are the earliest a model may go: the description +// says so. +func TestGeminiDatesAreTheEarliest(t *testing.T) { + saved := kittest.Pages{retire.Gemini.URL: "retire/testdata/gemini-deprecations.md"} + for _, e := range kittest.Page(t, kittest.Env(t, saved), Plugin{Page: retire.Gemini, Archiver: &kittest.Archive{T: t, Pages: saved}}) { + if !strings.Contains(e.Description, "the earliest date Google gives") { + t.Fatalf("%s: %q", e.Subject.Name, e.Description) + } + } +} diff --git a/plugins/notices/notices.go b/plugins/notices/notices.go index 64248a7..f8b104a 100644 --- a/plugins/notices/notices.go +++ b/plugins/notices/notices.go @@ -76,6 +76,12 @@ func init() { Watches: "Generative AI model deprecations on Vertex AI", URLs: []string{"https://docs.cloud.google.com/feeds/generative-ai-on-vertex-ai-release-notes.xml"}, Plugin: Plugin{Page: feed.VertexAIModels, Archiver: kit.Wayback{}}, + }, { + ID: "gemini-models", Layer: plugin.LayerAIModels, Page: "providers/google-gemini-models.md", + Watches: "Gemini API model shutdown dates (the earliest Google gives) and their replacements, from Google's own deprecations table", + URLs: []string{"https://ai.google.dev/gemini-api/docs/deprecations", "https://aistudio.google.com/docs/deprecations"}, + Packages: []string{"pypi:google-genai", "npm:@google/genai"}, + Plugin: Plugin{Page: retire.Gemini, Archiver: kit.Wayback{}}, }}, }) plugin.RegisterProvider(plugin.Provider{ diff --git a/plugins/notices/retire/formats.go b/plugins/notices/retire/formats.go new file mode 100644 index 0000000..f77f320 --- /dev/null +++ b/plugins/notices/retire/formats.go @@ -0,0 +1,71 @@ +package retire + +import ( + "regexp" + "strings" +) + +var ( + // markdocCell is one cell of a Markdoc table: " * `gemini-2.0-flash`". + markdocCell = regexp.MustCompile(`^\s*\* ?(.*)$`) + markdocHeading = regexp.MustCompile(`^(#+ .*?)\s*(\{%.*%\})?\s*$`) +) + +// markdocPipes reads a Markdoc page's tables ({% table %}, a "* cell" per +// line, rows split by "---", the first row the header) into pipe tables, +// each under the heading above it. Nothing else on the page is kept. +func markdocPipes(page []byte) []byte { + var out []string + var rows [][]string + var cur []string + in := false + flush := func() { + if len(cur) > 0 { + rows = append(rows, cur) + cur = nil + } + } + for _, line := range strings.Split(strings.ReplaceAll(string(page), "\r\n", "\n"), "\n") { + t := strings.TrimSpace(line) + switch { + case !in && strings.HasPrefix(t, "#"): + if m := markdocHeading.FindStringSubmatch(t); m != nil { + out = append(out, m[1]) + } + case !in && t == "{% table %}": + in, rows, cur = true, nil, nil + case in && t == "{% /table %}": + flush() + out = append(out, pipeTable(rows)...) + in = false + case in && t == "---": + flush() + case in && strings.HasPrefix(t, "*"): + cur = append(cur, strings.TrimSpace(markdocCell.FindStringSubmatch(line)[1])) + case in && t != "" && len(cur) > 0: + // A cell's text continued on the next line. + cur[len(cur)-1] += " " + t + } + } + return []byte(strings.Join(out, "\n") + "\n") +} + +// pipeTable writes rows (the first the header) as a Markdown pipe table, +// escaping a pipe inside a cell. +func pipeTable(rows [][]string) []string { + if len(rows) == 0 { + return nil + } + line := func(cells []string) string { + esc := make([]string, len(cells)) + for i, c := range cells { + esc[i] = strings.ReplaceAll(c, "|", `\|`) + } + return "| " + strings.Join(esc, " | ") + " |" + } + out := []string{"", line(rows[0]), "|" + strings.Repeat(" --- |", len(rows[0]))} + for _, r := range rows[1:] { + out = append(out, line(r)) + } + return append(out, "") +} diff --git a/plugins/notices/retire/notices.go b/plugins/notices/retire/notices.go index 637239a..9b941b8 100644 --- a/plugins/notices/retire/notices.go +++ b/plugins/notices/retire/notices.go @@ -23,7 +23,7 @@ func (p Page) PageURL() string { return p.URL } // Find reads every retirement on the page. func (p Page) Find(page []byte) (kit.Notices, error) { - rs, err := Parse(page, p.Keep) + rs, err := Parse(p.Format.Pipes(page), p.Keep) return Retirements(rs), err } diff --git a/plugins/notices/retire/providers.go b/plugins/notices/retire/providers.go index 61fbc03..d25a9b5 100644 --- a/plugins/notices/retire/providers.go +++ b/plugins/notices/retire/providers.go @@ -1,6 +1,9 @@ package retire -import "strings" +import ( + "regexp" + "strings" +) // OpenAI's deprecations page (checked 2026-10-13). Its tables cover every // kind of model; these events are for the text models the Chat Completions @@ -46,3 +49,25 @@ func openAIText(name string) bool { } return false } + +// googleModel is a model id as code sends it, nothing around it: a cell +// with a footnote mark ("textembedding-gecko@003 *") isn't read. +var googleModel = regexp.MustCompile(`^[a-z0-9][a-z0-9.@_-]*$`) + +// Gemini is the Gemini API's deprecations page (ai.google.dev, served by +// aistudio.google.com as markdown, checked 2026-11-21): one Markdoc table per +// model family, | Model | Release date | Shutdown date | Recommended +// replacement |, current models with "No shutdown date announced", shut-down +// ones under "Deprecated models". Every model there is one code names in a +// request (text, image, video, audio, embedding: all through the same SDK); +// the managed agents' tables name an agent, not a model, and are skipped. +// Google says its dates are the earliest a model may be shut down. +var Gemini = Page{ + API: "google/gemini-models", + Provider: "google", + Vendor: "Google", + URL: "https://aistudio.google.com/docs/deprecations", + Format: FormatMarkdoc, + Keep: googleModel.MatchString, + Earliest: true, +} diff --git a/plugins/notices/retire/retire.go b/plugins/notices/retire/retire.go index f934b18..e7e7646 100644 --- a/plugins/notices/retire/retire.go +++ b/plugins/notices/retire/retire.go @@ -3,11 +3,15 @@ // OpenAPI differ. There is no spec to diff, only the provider's own table of // shutdown date, model and named replacement, so this reads the table. // -// Both providers serve the page as markdown at its URL plus ".md" (checked -// 2026-10-13), and both write each announcement as a table whose first column -// is the date the model stops working. The event cites a Wayback Machine -// snapshot of that markdown (kit/), never the live page: the contract -// requires a source that can't change under the event. +// A page is a Markdown pipe table (OpenAI's and Anthropic's pages, served as +// markdown at their URL plus ".md", checked 2026-10-13), a Markdoc table +// (Google's Gemini API page, {% table %} with one "* cell" per line, checked +// 2026-11-21), read into pipe rows first, with its headings, so one parser +// reads every page. A table is a retirement +// table when it has a shutdown or retirement date column, a model column and +// a replacement column, in any order. The event cites a Wayback Machine +// snapshot of the page (kit/), never the live page: the contract requires a +// source that can't change under the event. package retire import ( @@ -25,12 +29,27 @@ type Page struct { API string // the source id the events carry: "openai/models" Provider string // the model subject's provider: "openai" Vendor string // for sentences: "OpenAI" - URL string // the page as markdown + URL string // the page, as markdown + // Format is how the page writes its tables: Markdown pipe tables (the + // default), Markdoc or HTML. + Format Format // Keep says whether a model name belongs to this source: the operations // above take text models, not image, audio or embedding ones. Keep func(name string) bool + // Earliest says the page's dates are the earliest a model may be shut + // down, not the day it is (Google's Gemini API page): the description + // says so. + Earliest bool } +// Format is how a page writes its tables. +type Format string + +const ( + FormatMarkdown Format = "" + FormatMarkdoc Format = "markdoc" +) + // Retirement is one model name the provider stops serving on Date, with the // replacement it names. An alias gets its own Retirement, with the row it // came from. @@ -47,6 +66,16 @@ var ( ticked = regexp.MustCompile("`([^`]+)`") ) +// Pipes is the page's tables as Markdown pipe tables, each under the +// heading above it: the page itself when it's Markdown. +func (f Format) Pipes(page []byte) []byte { + switch f { + case FormatMarkdoc: + return markdocPipes(page) + } + return page +} + var dateLayouts = []string{"January 2, 2006", "Jan 2, 2006", "2006-01-02"} // Parse reads every retirement table on the page. A model listed more than @@ -57,6 +86,7 @@ var dateLayouts = []string{"January 2, 2006", "Jan 2, 2006", "2006-01-02"} // points at a model that no longer works. func Parse(page []byte, keep func(string) bool) ([]Retirement, error) { lines := strings.Split(strings.ReplaceAll(string(page), "\r\n", "\n"), "\n") + headerAt := 0 var out []Retirement seen := map[string]bool{} heading := "" @@ -67,23 +97,31 @@ func Parse(page []byte, keep func(string) bool) ([]Retirement, error) { continue } header := cells(line) - if len(header) < 3 || !dateHeader.MatchString(header[0]) { + when := -1 + for c, h := range header { + if dateHeader.MatchString(h) { + when = c + break + } + } + if len(header) < 3 || when < 0 { continue } - model, repl := column(header, "model"), column(header, "replacement", "substitute") - if model < 0 || repl < 0 { - continue // an endpoint ("System") or a training-price table: no model to replace + model, repl := column(header, "model"), column(header, "replacement", "substitute", "upgrade") + if model < 0 || repl < 0 || model == repl { + continue // an endpoint ("System"), an agent or a training-price table: no model to replace } + headerAt = i i++ // the |---| row for i+1 < len(lines) && strings.HasPrefix(strings.TrimSpace(lines[i+1]), "|") { i++ row := strings.TrimSpace(lines[i]) c := cells(row) - if len(c) <= model || len(c) <= repl { + if len(c) <= model || len(c) <= repl || len(c) <= when { return nil, fmt.Errorf("a short row under %q: %s", heading, row) } names := ticked.FindAllStringSubmatch(c[model], -1) - date, err := parseDate(c[0]) + date, err := parseDate(c[when]) if err != nil { // "To be announced": not a retirement yet, and the newer word on // these names, so an older row's date for them doesn't count. @@ -92,7 +130,7 @@ func Parse(page []byte, keep func(string) bool) ([]Retirement, error) { } continue } - excerpt := strings.Join([]string{heading, strings.TrimSpace(lines[headerLine(lines, i)]), row}, "\n") + excerpt := strings.Join([]string{heading, strings.TrimSpace(lines[headerAt]), row}, "\n") for _, m := range names { name := m[1] if seen[name] || !keep(name) { @@ -110,14 +148,6 @@ func Parse(page []byte, keep func(string) bool) ([]Retirement, error) { return out, nil } -// headerLine walks back from a row to its table's header. -func headerLine(lines []string, i int) int { - for i > 0 && strings.HasPrefix(strings.TrimSpace(lines[i-1]), "|") { - i-- - } - return i -} - // follow replaces a replacement that is itself retired with its own // replacement, recording the hops: gpt-3.5-turbo-0613's named replacement is // gpt-3.5-turbo, which shuts down on 2026-10-23 for gpt-5.6-terra. @@ -173,8 +203,8 @@ func cells(row string) []string { } func column(header []string, words ...string) int { - for i, h := range header { - for _, w := range words { + for _, w := range words { + for i, h := range header { if strings.Contains(strings.ToLower(h), w) { return i } @@ -211,7 +241,7 @@ func Events(p Page, rs []Retirement, sourceURL string, now time.Time) ([]event.E ChangeType: event.ChangeTypeBreaking, Breaking: true, Subject: subject, - Description: fmt.Sprintf("Model %q is shut down on %s: %s requests naming it fail from that date.", r.Model, r.Date, p.Vendor), + Description: describe(p, r), MigrationHint: h, SourceURL: sourceURL, SourceExcerpt: r.Excerpt, @@ -227,6 +257,13 @@ func Events(p Page, rs []Retirement, sourceURL string, now time.Time) ([]event.E return events, errs } +func describe(p Page, r Retirement) string { + if p.Earliest { + return fmt.Sprintf("Model %q can be shut down from %s, the earliest date %s gives: %s requests naming it fail once it is.", r.Model, r.Date, p.Vendor, p.Vendor) + } + return fmt.Sprintf("Model %q is shut down on %s: %s requests naming it fail from that date.", r.Model, r.Date, p.Vendor) +} + // replacement is the one model the provider names, when its replacement cell // is exactly one model name: not none, not several, not a model with a // setting (`gpt-5.6-sol` (`reasoning.mode: pro`)). The patch-it client opens @@ -242,6 +279,9 @@ func replacement(cell string) string { func hint(vendor string, r Retirement) string { repl := strings.TrimSpace(r.Replacement) + if repl == "" { + return fmt.Sprintf("%s names no replacement model.", vendor) + } if First(repl) == "" { return fmt.Sprintf("%s names no replacement model: %s", vendor, repl) } diff --git a/plugins/notices/retire/testdata/README.md b/plugins/notices/retire/testdata/README.md index b4c3b47..23e2600 100644 --- a/plugins/notices/retire/testdata/README.md +++ b/plugins/notices/retire/testdata/README.md @@ -2,7 +2,7 @@ The two providers' deprecations pages, as markdown (each page's URL plus `.md`). `retire`'s tests and the `openai-models` / `anthropic-models` golden tests (`plugins/notices`) read them. -**License:** excerpts for testing; © OpenAI and © Anthropic respectively. Not covered by this repo's license. +**License:** excerpts for testing; © OpenAI and © Anthropic respectively. Not covered by this repo's license. Google's page is © Google, CC BY 4.0 (Google's developer documentation). **Trimmed.** Each file keeps the page title and, for every retirement table that names at least one model the plugin keeps (text models code sends), the section heading above it and the whole table, copied unchanged. Prose, notice-period policy, endpoint tables and tables of only image, audio or embedding models were left out. `retire.Parse` returns exactly the same retirements from the trimmed and the full pages, so the golden files didn't change. @@ -10,3 +10,4 @@ The two providers' deprecations pages, as markdown (each page's URL plus `.md`). |---|---|---|---| | `openai-deprecations.md` | https://developers.openai.com/api/docs/deprecations.md | 2026-10-13 | "\| October 23, 2026 \| `gpt-4-0613` \\\| `gpt-4`, … \| `gpt-5.6-sol` \|" | | `anthropic-deprecations.md` | https://platform.claude.com/docs/en/about-claude/model-deprecations.md | 2026-10-13 | "\| November 30, 2026 \| `claude-sonnet-4-5-20250929` \| `claude-sonnet-5-5` \|" | +| `gemini-deprecations.md` | https://aistudio.google.com/docs/deprecations (where https://ai.google.dev/gemini-api/docs/deprecations redirects; served as Markdown). Kept whole, byte for byte | 2026-11-21 | "\| `gemini-2.0-flash` \| February 5, 2025 \| June 1, 2026 \| `gemini-3.6-flash` \|", as Markdoc `* cell` lines | diff --git a/plugins/notices/retire/testdata/gemini-deprecations.md b/plugins/notices/retire/testdata/gemini-deprecations.md new file mode 100644 index 0000000..f28aefe --- /dev/null +++ b/plugins/notices/retire/testdata/gemini-deprecations.md @@ -0,0 +1,1001 @@ +> ## AI Agent Context +> - Full documentation index: https://aistudio.google.com/llms.txt +> - Gemini Docs MCP server (consistent live info): https://gemini-api-docs-mcp.dev +> - Coding agent skills & setup guide: https://aistudio.google.com/docs/coding-agents.md + +# Gemini deprecations + +This page lists the known deprecation schedules for [stable +(GA)](/docs/models#stable) and [preview](/docs/models#preview) models and for +managed agents in the Gemini API. A "**deprecation**" is the announcement that +we no longer provide support for a model, and that it will be "**shut down**" in +the near future. Once a model is "**shutdown**", it is completely turned off, and +the endpoint is no longer available. + +Deprecation announcements are made on the [Release notes](/docs/changelog) page, +and the announced earliest shutdown dates are tracked on this page. To pick an upgrade target for your workload, see [Choosing a model](/docs/choosing-a-model#upgrade-paths). +Already-shutdown models and agents are listed under the **Deprecated models** +and **Deprecated agents** sections. + +{% callout type="note" %} + Note: The **shutdown dates listed in the table indicate the *earliest possible + dates* on which a model might be retired**. We will communicate the exact + shutdown date to users with advance notice to ensure a smooth transition to a + replacement model. + +{% /callout %} + +## Gemini 4 models {% id="gemini-4-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-4-neon` + * November 18, 2026 + * No shutdown date announced + * + + --- + + * `gemini-4-hydrogen` + * November 12, 2026 + * No shutdown date announced + * + + --- + + * `gemini-4-carbon` + * November 10, 2026 + * No shutdown date announced + * + + --- + + * `gemini-4-argon` + * October 13, 2026 + * No shutdown date announced + * +{% /table %} + +## Gemini 3 models {% id="gemini-3-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-3.8-flash-tts` + * September 22, 2026 + * No shutdown date announced + * + + --- + + * `gemini-3.8-flash-lite-tts` + * September 22, 2026 + * No shutdown date announced + * + + --- + + * `gemini-3.8-live` + * September 15, 2026 + * No shutdown date announced + * + + --- + + * `gemini-3.8-live-extended-thinking` + * September 15, 2026 + * No shutdown date announced + * + + --- + + * `gemini-3.8-flash` + * September 2, 2026 + * No shutdown date announced + * + + --- + + * `gemini-3.7-flash` + * August 13, 2026 + * N/A + * `gemini-3.8-flash` (`gemini-3.7-flash` is no longer available in Google AI Studio; the endpoint is not shutting down and automatically routes API requests to `gemini-3.8-flash`) + + --- + + * `gemini-3.6-flash` + * July 21, 2026 + * No shutdown date announced + * + + --- + + * `gemini-3.5-flash-lite` + * July 21, 2026 + * No shutdown date announced + * + + --- + + * `gemini-3.5-flash` + * May 19, 2026 + * N/A + * `gemini-3.6-flash` (`gemini-3.5-flash` is no longer available in Google AI Studio; the endpoint is not shutting down and automatically routes API requests to `gemini-3.6-flash`) + + --- + + * `gemini-3.1-flash-lite` + * May 7, 2026 + * May 7, 2027 + * `gemini-3.5-flash-lite` +{% /table %} + +### Preview models {% id="gemini-3-preview-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-3.1-flash-tts-preview` + * February 26, 2026 + * December 18, 2026 + * `gemini-3.8-flash-tts` or `gemini-3.8-flash-lite-tts` + + --- + + * `gemini-3.1-pro-preview` + * February 19, 2026 + * No shutdown date announced + * + + --- + + * `gemini-3-flash-preview` + * December 17, 2025 + * No shutdown date announced + * `gemini-3.6-flash` +{% /table %} + +### Deprecated models {% id="gemini-3-deprecated-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-3-pro-preview` + * November 18, 2025 + * March 9, 2026 + * `gemini-3.1-pro-preview` + + --- + + * `gemini-3.1-flash-lite-preview` + * March 3, 2026 + * May 25, 2026 + * `gemini-3.1-flash-lite` +{% /table %} + +## Gemini 2.5 Pro models {% id="gemini-2.5-pro-models" %} + +{% callout type="caution" %} + `gemini-2.5-pro` is deprecated and is no longer available to select in Google AI + Studio. Access through the API is limited to existing users who have actively + used it in the past. Effective December 1, 2026, all API requests to + `gemini-2.5-pro` will automatically route to + [`gemini-3.8-flash`](/docs/models/gemini-3.8-flash) and be billed at + [Gemini 3.8 Flash rates](/docs/pricing#gemini-3.8-flash). Review the breaking + API changes in the + [Gemini 3.8 Flash migration guide](/docs/whats-new-gemini-3.8#migrate-to-gemini-3-8-flash) + before December 1, 2026. + +{% /callout %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-2.5-pro` + * June 17, 2025 + * December 1, 2026 + * `gemini-3.8-flash` (`gemini-2.5-pro` is no longer available in Google AI Studio; effective December 1, 2026, API requests to `gemini-2.5-pro` will automatically route to `gemini-3.8-flash`) +{% /table %} + +### Deprecated models {% id="gemini-2.5-pro-deprecated-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-2.5-computer-use-preview-10-2025` + * October 7, 2025 + * July 28, 2026 + * `gemini-3.8-flash` + + --- + + * `gemini-2.5-pro-preview-03-25` + * March 3, 2025 + * December 2, 2025 + * `gemini-3.8-flash` + + --- + + * `gemini-2.5-pro-preview-05-06` + * May 6, 2025 + * December 2, 2025 + * `gemini-3.8-flash` + + --- + + * `gemini-2.5-pro-preview-06-05` + * June 5, 2025 + * December 2, 2025 + * `gemini-3.8-flash` +{% /table %} + +## Gemini 2.5 Flash models {% id="gemini-2.5-flash-models" %} + +{% callout type="caution" %} + `gemini-2.5-flash` is deprecated and is no longer available to select in Google + AI Studio. Effective December 1, 2026, all API requests to `gemini-2.5-flash` + will automatically route to + [`gemini-3.5-flash-lite`](/docs/models/gemini-3.5-flash-lite) and be billed at + [Gemini 3.5 Flash-Lite rates](/docs/pricing#gemini-3.5-flash-lite). Review the + breaking API changes in the + [Gemini 3.5 Flash-Lite migration guide](/docs/whats-new-gemini-3.6#migrate-to-gemini-3-5-flash-lite) + before December 1, 2026. Access to the 2.5 models is limited to users who have + actively used them in the past. `gemini-2.5-flash-lite` is not deprecated and + remains available through the API until further notice. + +{% /callout %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-2.5-flash` + * June 17, 2025 + * December 1, 2026 + * `gemini-3.5-flash-lite` (`gemini-2.5-flash` is no longer available in Google AI Studio; effective December 1, 2026, API requests to `gemini-2.5-flash` will automatically route to `gemini-3.5-flash-lite`) + + --- + + * `gemini-2.5-flash-lite` + * July 22, 2025 + * No shutdown date announced + * +{% /table %} + +### Deprecated models {% id="gemini-2.5-flash-deprecated-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-2.5-flash-lite-preview-09-2025` + * September 25, 2025 + * March 31, 2026 + * `gemini-3.1-flash-lite` + + --- + + * `gemini-2.5-flash-preview-05-20` + * May 20, 2025 + * November 18, 2025 + * `gemini-3.6-flash` + + --- + + * `gemini-2.5-flash-preview-09-2025` + * September 25, 2025 + * February 17, 2026 + * `gemini-3.6-flash` +{% /table %} + +## Gemini 2.0 models {% id="gemini-2.0-models" %} + +### Deprecated models {% id="gemini-2.0-deprecated-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-2.0-flash` + * February 5, 2025 + * June 1, 2026 + * `gemini-3.6-flash` + + --- + + * `gemini-2.0-flash-001` + * February 5, 2025 + * June 1, 2026 + * `gemini-3.6-flash` + + --- + + * `gemini-2.0-flash-lite` + * February 25, 2025 + * June 1, 2026 + * `gemini-3.1-flash-lite` + + --- + + * `gemini-2.0-flash-lite-001` + * February 25, 2025 + * June 1, 2026 + * `gemini-3.1-flash-lite` + + --- + + * `gemini-2.0-flash-lite-preview` + * February 5, 2025 + * December 9, 2025 + * `gemini-3.1-flash-lite` + + --- + + * `gemini-2.0-flash-lite-preview-02-05` + * February 5, 2025 + * December 9, 2025 + * `gemini-3.1-flash-lite` +{% /table %} + +## Live API models {% id="live-api-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-3.8-live` + * September 15, 2026 + * No shutdown date announced + * + + --- + + * `gemini-3.8-live-extended-thinking` + * September 15, 2026 + * No shutdown date announced + * + + --- + + * `gemini-3.5-transcribe-live` + * August 2026 + * No shutdown date announced + * +{% /table %} + +### Preview models {% id="live-api-preview-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-3.5-live-translate-preview` + * June 2026 + * No shutdown date announced + * + + --- + + * `gemini-3.1-flash-live-preview` + * March 11, 2026 + * No shutdown date announced + * `gemini-3.8-live` + + --- + + * `gemini-2.5-flash-native-audio-preview-12-2025` + * December 12, 2025 + * March 31, 2027 + * `gemini-3.8-live` +{% /table %} + +### Deprecated models {% id="live-api-deprecated-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-live-2.5-flash-preview` + * June 17, 2025 + * December 9, 2025 + * `gemini-3.8-live` + + --- + + * `gemini-2.0-flash-live-001` + * April 9, 2025 + * December 9, 2025 + * `gemini-3.8-live` +{% /table %} + +## Audio models {% id="audio-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-3.5-transcribe` + * August 2026 + * No shutdown date announced + * +{% /table %} + +### Preview models {% id="audio-preview-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-2.5-flash-preview-tts` + * May 20, 2025 + * December 18, 2026 + * `gemini-3.8-flash-tts` or `gemini-3.8-flash-lite-tts` + + --- + + * `gemini-2.5-pro-preview-tts` + * May 20, 2025 + * December 18, 2026 + * `gemini-3.8-flash-tts` or `gemini-3.8-flash-lite-tts` +{% /table %} + +## Embedding models {% id="embedding-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-embedding-2` + * April 22, 2026 + * No shutdown date announced + * + + --- + + * `gemini-embedding-001` + * July 14, 2025 + * May 14, 2028 + * `gemini-embedding-2` +{% /table %} + +### Deprecated models {% id="embedding-deprecated-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-embedding-2-preview` + * March 10, 2026 + * November 6, 2026 + * `gemini-embedding-2` (effective November 6, 2026, API requests to `gemini-embedding-2-preview` route to `gemini-embedding-2`) + + --- + + * `text-embedding-004` + * April 9, 2024 + * January 14, 2026 + * `gemini-embedding-2` + + --- + + * `embedding-001` + * April 9, 2024 + * October 30, 2025 + * `gemini-embedding-2` + + --- + + * `embedding-gecko-001` + * + * October 30, 2025 + * `gemini-embedding-2` + + --- + + * `gemini-embedding-exp` + * + * October 30, 2025 + * `gemini-embedding-2` + + --- + + * `gemini-embedding-exp-03-07` + * + * October 30, 2025 + * `gemini-embedding-2` +{% /table %} + +## Nano Banana models {% id="nano-banana-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-nano-banana-2.1` + * October 6, 2026 + * No shutdown date announced + * + + --- + + * `gemini-3.1-flash-lite-image` + * June 30, 2026 + * No shutdown date announced + * + + --- + + * `gemini-3.1-flash-image` + * May 28, 2026 + * No shutdown date announced + * `gemini-nano-banana-2.1` + + --- + + * `gemini-3-pro-image` + * May 28, 2026 + * No shutdown date announced + * + + --- + + * `gemini-2.5-flash-image` + * October 2, 2025 + * March 15, 2027 + * `gemini-3.1-flash-lite-image` +{% /table %} + +### Deprecated models {% id="nano-banana-deprecated-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-3.1-flash-image-preview` + * February 26, 2026 + * June 25, 2026 + * `gemini-nano-banana-2.1` + + --- + + * `gemini-3-pro-image-preview` + * November 20, 2025 + * June 25, 2026 + * `gemini-3-pro-image` + + --- + + * `gemini-2.5-flash-image-preview` + * May 7, 2025 + * January 15, 2026 + * `gemini-nano-banana-2.1` + + --- + + * `gemini-2.0-flash-preview-image-generation` + * May 7, 2025 + * November 14, 2025 + * `gemini-nano-banana-2.1` +{% /table %} + +## Imagen models {% id="imagen-models" %} + +### Deprecated models {% id="imagen-deprecated-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `imagen-4.0-generate-001` + * June 24, 2025 + * August 17, 2026 + * `gemini-nano-banana-2.1` + + --- + + * `imagen-4.0-ultra-generate-001` + * June 24, 2025 + * August 17, 2026 + * `gemini-nano-banana-2.1` + + --- + + * `imagen-4.0-fast-generate-001` + * June 24, 2025 + * August 17, 2026 + * `gemini-nano-banana-2.1` + + --- + + * `imagen-4.0-generate-preview-06-06` + * June 24, 2025 + * February 17, 2026 + * `gemini-nano-banana-2.1` + + --- + + * `imagen-4.0-ultra-generate-preview-06-06` + * June 24, 2025 + * February 17, 2026 + * `gemini-nano-banana-2.1` + + --- + + * `imagen-3.0-generate-002` + * February 6, 2025 + * November 10, 2025 + * `gemini-nano-banana-2.1` +{% /table %} + +## Veo models {% id="veo-models" %} + +### Deprecated models {% id="veo-deprecated-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `veo-3.1-lite-generate-preview` + * March 31, 2026 + * October 22, 2026 + * `gemini-omni-1.2-flash` + + --- + + * `veo-3.1-generate-preview` + * October 15, 2025 + * October 22, 2026 + * `gemini-omni-1.2-flash` + + --- + + * `veo-3.1-fast-generate-preview` + * October 15, 2025 + * October 22, 2026 + * `gemini-omni-1.2-flash` + + --- + + * `veo-3.0-generate-001` + * September 9, 2025 + * June 30, 2026 + * `gemini-omni-1.2-flash` or the GA models on the [Gemini Enterprise Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/veo/3-1-generate) + + --- + + * `veo-3.0-fast-generate-001` + * September 9, 2025 + * June 30, 2026 + * `gemini-omni-1.2-flash` or the GA models on the [Gemini Enterprise Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/veo/3-1-generate) + + --- + + * `veo-2.0-generate-001` + * April 9, 2025 + * June 30, 2026 + * `gemini-omni-1.2-flash` or the GA models on the [Gemini Enterprise Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/veo/3-1-generate) + + --- + + * `veo-3.0-generate-preview` + * July 31, 2025 + * November 12, 2025 + * `gemini-omni-1.2-flash` + + --- + + * `veo-3.0-fast-generate-preview` + * July 31, 2025 + * November 12, 2025 + * `gemini-omni-1.2-flash` +{% /table %} + +## Gemini Omni Flash models {% id="gemini-omni-flash-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-omni-1.2-flash` + * November 5, 2026 + * No shutdown date announced + * + + --- + + * `gemini-omni-1.1-flash` + * August 27, 2026 + * December 3, 2026 + * `gemini-omni-1.2-flash` (Effective December 3, 2026, the endpoint is + automatically routing API requests to + `gemini-omni-1.2-flash`) +{% /table %} + +### Deprecated models {% id="gemini-omni-flash-deprecated-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-omni-flash-preview` + * June 30, 2026 + * October 22, 2026 + * `gemini-omni-1.2-flash` +{% /table %} + +## Genie models {% id="genie-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * [`genie-4`](/docs/models/genie-4) + * November 19, 2026 + * No shutdown date announced + * +{% /table %} + +## Lyria models {% id="lyria-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `lyria-3.5` + * September 3, 2026 + * No shutdown date announced + * +{% /table %} + +### Preview models {% id="lyria-preview-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `lyria-3-clip-preview` + * March 25, 2026 + * No shutdown date announced + * + + --- + + * `lyria-3-pro-preview` + * March 25, 2026 + * No shutdown date announced + * `lyria-3.5` + + --- + + * `lyria-realtime-exp` + * May 20, 2025 + * No shutdown date announced + * +{% /table %} + +## Robotics models {% id="robotics-models" %} + +### Preview models {% id="robotics-preview-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-robotics-er-2-preview` + * July 30, 2026 + * No shutdown date announced + * + + --- + + * `gemini-robotics-er-2-streaming-preview` + * July 30, 2026 + * No shutdown date announced + * +{% /table %} + +### Deprecated models {% id="robotics-deprecated-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `gemini-robotics-er-1.6-preview` + * April 14, 2026 + * August 31, 2026 + * `gemini-robotics-er-2-preview` + + --- + + * `gemini-robotics-er-1.5-preview` + * September 25, 2025 + * April 30, 2026 + * `gemini-robotics-er-2-preview` +{% /table %} + +## Gemini Decision models {% id="gemini-decision-models" %} + +{% table %} + * Model + * Release date + * Shutdown date + * Recommended replacement + + --- + + * [`gemini-decision-1`](/docs/models/gemini-decision-1) + * November 11, 2026 + * No shutdown date announced + * +{% /table %} + +## Managed agents {% id="managed-agents" %} + +### Preview agents {% id="managed-agents-preview-agents" %} + +{% table %} + * Agent + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `antigravity-preview-09-2026` + * September 17, 2026 + * No shutdown date announced + * + + --- + + * `deep-research-preview-04-2026` + * April 21, 2026 + * No shutdown date announced + * + + --- + + * `deep-research-max-preview-04-2026` + * April 21, 2026 + * No shutdown date announced + * +{% /table %} + +### Deprecated agents {% id="managed-agents-deprecated-agents" %} + +{% table %} + * Agent + * Release date + * Shutdown date + * Recommended replacement + + --- + + * `deep-research-pro-preview-12-2025` + * December 11, 2025 + * October 23, 2026 + * `deep-research-preview-04-2026` + + --- + + * `antigravity-preview-05-2026` + * May 19, 2026 + * October 5, 2026 + * `antigravity-preview-09-2026` +{% /table %} + diff --git a/plugins/notices/retirements_golden_test.go b/plugins/notices/retirements_golden_test.go index 1bfaa74..1949d70 100644 --- a/plugins/notices/retirements_golden_test.go +++ b/plugins/notices/retirements_golden_test.go @@ -8,13 +8,15 @@ import ( "github.com/patch-it-dev/patch-it-plugins/plugins/notices/retire" ) -// Both providers' saved pages (2026-10-13) in, every event out. The archive +// Each provider's saved page (OpenAI's and Anthropic's 2026-10-13, Google's +// 2026-11-21) in, every event out. The archive // serves the same copy as the snapshot, so the events cite it; a second read // of the unchanged page asks for no snapshot. func TestRetirementsGolden(t *testing.T) { for file, page := range map[string]retire.Page{ "openai-deprecations.md": retire.OpenAI, "anthropic-deprecations.md": retire.Anthropic, + "gemini-deprecations.md": retire.Gemini, } { t.Run(page.API, func(t *testing.T) { saved := kittest.Pages{page.URL: "retire/testdata/" + file} diff --git a/plugins/notices/retirements_registered_test.go b/plugins/notices/retirements_registered_test.go index 42cee34..99f0f28 100644 --- a/plugins/notices/retirements_registered_test.go +++ b/plugins/notices/retirements_registered_test.go @@ -8,7 +8,7 @@ import ( ) func TestRetirementsRegisterThemselves(t *testing.T) { - for _, p := range []retire.Page{retire.OpenAI, retire.Anthropic} { + for _, p := range []retire.Page{retire.OpenAI, retire.Anthropic, retire.Gemini} { kittest.Registered(t, Plugin{Page: p}) } } diff --git a/plugins/notices/testdata/golden/google-gemini-models.json b/plugins/notices/testdata/golden/google-gemini-models.json new file mode 100644 index 0000000..99aaa17 --- /dev/null +++ b/plugins/notices/testdata/golden/google-gemini-models.json @@ -0,0 +1,1072 @@ +[ + { + "id": 1, + "fingerprint": "sha256:caea2393099a2cf5bdbb0fbc226f25dfe2dfce8afb3267eec5faf86162821f2c", + "api": "google/gemini-models", + "version": "2027-05-07", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-3.1-flash-lite", + "replacement": "gemini-3.5-flash-lite" + }, + "description": "Model \"gemini-3.1-flash-lite\" can be shut down from 2027-05-07, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.5-flash-lite` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "## Gemini 3 models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-3.1-flash-lite` | May 7, 2026 | May 7, 2027 | `gemini-3.5-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 2, + "fingerprint": "sha256:8858145e5f4653df2466841a60dc2868c6f426c5af9150f55afc1fda77513773", + "api": "google/gemini-models", + "version": "2026-12-18", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-3.1-flash-tts-preview" + }, + "description": "Model \"gemini-3.1-flash-tts-preview\" can be shut down from 2026-12-18, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.8-flash-tts` or `gemini-3.8-flash-lite-tts` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Preview models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-3.1-flash-tts-preview` | February 26, 2026 | December 18, 2026 | `gemini-3.8-flash-tts` or `gemini-3.8-flash-lite-tts` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 3, + "fingerprint": "sha256:0cac57f7a4434d25aae59532745358c6f44758d0c4ddf897a2927a170b6dbf28", + "api": "google/gemini-models", + "version": "2026-03-09", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-3-pro-preview", + "replacement": "gemini-3.1-pro-preview" + }, + "description": "Model \"gemini-3-pro-preview\" can be shut down from 2026-03-09, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.1-pro-preview` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-3-pro-preview` | November 18, 2025 | March 9, 2026 | `gemini-3.1-pro-preview` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 4, + "fingerprint": "sha256:3f4158206697b71cbe0dbbe74a52310d52e6f44033349189349d8d8128e59336", + "api": "google/gemini-models", + "version": "2026-05-25", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-3.1-flash-lite-preview", + "replacement": "gemini-3.5-flash-lite" + }, + "description": "Model \"gemini-3.1-flash-lite-preview\" can be shut down from 2026-05-25, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.5-flash-lite` instead: Google's recommended replacement. (Google first named gemini-3.1-flash-lite, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-3.1-flash-lite-preview` | March 3, 2026 | May 25, 2026 | `gemini-3.1-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 5, + "fingerprint": "sha256:871f6f3d545e0f3bf03421077213fe06548c79e9e8ddf9954d79b95e15adc17d", + "api": "google/gemini-models", + "version": "2026-12-01", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-pro" + }, + "description": "Model \"gemini-2.5-pro\" can be shut down from 2026-12-01, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.8-flash` (`gemini-2.5-pro` is no longer available in Google AI Studio; effective December 1, 2026, API requests to `gemini-2.5-pro` will automatically route to `gemini-3.8-flash`) instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "## Gemini 2.5 Pro models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-pro` | June 17, 2025 | December 1, 2026 | `gemini-3.8-flash` (`gemini-2.5-pro` is no longer available in Google AI Studio; effective December 1, 2026, API requests to `gemini-2.5-pro` will automatically route to `gemini-3.8-flash`) |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 6, + "fingerprint": "sha256:c02264b3e06bca3097caafa91d4a6dada49368e16d087f58ff1debbffc121a43", + "api": "google/gemini-models", + "version": "2026-07-28", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-computer-use-preview-10-2025", + "replacement": "gemini-3.8-flash" + }, + "description": "Model \"gemini-2.5-computer-use-preview-10-2025\" can be shut down from 2026-07-28, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.8-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-computer-use-preview-10-2025` | October 7, 2025 | July 28, 2026 | `gemini-3.8-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 7, + "fingerprint": "sha256:2adc7a8dfc6a692ee12da231f25be750326a077e9b3cd26aa82764f23aa6acd2", + "api": "google/gemini-models", + "version": "2025-12-02", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-pro-preview-03-25", + "replacement": "gemini-3.8-flash" + }, + "description": "Model \"gemini-2.5-pro-preview-03-25\" can be shut down from 2025-12-02, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.8-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-pro-preview-03-25` | March 3, 2025 | December 2, 2025 | `gemini-3.8-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 8, + "fingerprint": "sha256:b225c413ec1d91b929eb2d7124814f928b9b04e18a9f08611c5fbfcf08e0a0e0", + "api": "google/gemini-models", + "version": "2025-12-02", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-pro-preview-05-06", + "replacement": "gemini-3.8-flash" + }, + "description": "Model \"gemini-2.5-pro-preview-05-06\" can be shut down from 2025-12-02, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.8-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-pro-preview-05-06` | May 6, 2025 | December 2, 2025 | `gemini-3.8-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 9, + "fingerprint": "sha256:4c2be4641bb22e1ae2d4c3b95da03ca363cd5e488a394cca4bc001f8915a835b", + "api": "google/gemini-models", + "version": "2025-12-02", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-pro-preview-06-05", + "replacement": "gemini-3.8-flash" + }, + "description": "Model \"gemini-2.5-pro-preview-06-05\" can be shut down from 2025-12-02, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.8-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-pro-preview-06-05` | June 5, 2025 | December 2, 2025 | `gemini-3.8-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 10, + "fingerprint": "sha256:60b751f9d3e759c519bbcabec3139c1de457129e71ed1ed966711f60af5374e1", + "api": "google/gemini-models", + "version": "2026-12-01", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-flash" + }, + "description": "Model \"gemini-2.5-flash\" can be shut down from 2026-12-01, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.5-flash-lite` (`gemini-2.5-flash` is no longer available in Google AI Studio; effective December 1, 2026, API requests to `gemini-2.5-flash` will automatically route to `gemini-3.5-flash-lite`) instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "## Gemini 2.5 Flash models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-flash` | June 17, 2025 | December 1, 2026 | `gemini-3.5-flash-lite` (`gemini-2.5-flash` is no longer available in Google AI Studio; effective December 1, 2026, API requests to `gemini-2.5-flash` will automatically route to `gemini-3.5-flash-lite`) |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 11, + "fingerprint": "sha256:b6d458a69ba2b51781274669929bebda33e4bebcf1927c1f63e23022386b265a", + "api": "google/gemini-models", + "version": "2026-03-31", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-flash-lite-preview-09-2025", + "replacement": "gemini-3.5-flash-lite" + }, + "description": "Model \"gemini-2.5-flash-lite-preview-09-2025\" can be shut down from 2026-03-31, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.5-flash-lite` instead: Google's recommended replacement. (Google first named gemini-3.1-flash-lite, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-flash-lite-preview-09-2025` | September 25, 2025 | March 31, 2026 | `gemini-3.1-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 12, + "fingerprint": "sha256:b81dc7696b0da57fbd358d29f47d03a65f8ae9260049cf302d1bd6b4a7098bf3", + "api": "google/gemini-models", + "version": "2025-11-18", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-flash-preview-05-20", + "replacement": "gemini-3.6-flash" + }, + "description": "Model \"gemini-2.5-flash-preview-05-20\" can be shut down from 2025-11-18, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.6-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-flash-preview-05-20` | May 20, 2025 | November 18, 2025 | `gemini-3.6-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 13, + "fingerprint": "sha256:8571eb750e46025a2b5ae4d0d645c01e1db00df8ffaa3ffae4a10a1f163d96b6", + "api": "google/gemini-models", + "version": "2026-02-17", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-flash-preview-09-2025", + "replacement": "gemini-3.6-flash" + }, + "description": "Model \"gemini-2.5-flash-preview-09-2025\" can be shut down from 2026-02-17, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.6-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-flash-preview-09-2025` | September 25, 2025 | February 17, 2026 | `gemini-3.6-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 14, + "fingerprint": "sha256:856205baa026aae1af080949fbba2a7272d91ad3467927e12bc533e6d318fe3e", + "api": "google/gemini-models", + "version": "2026-06-01", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.0-flash", + "replacement": "gemini-3.6-flash" + }, + "description": "Model \"gemini-2.0-flash\" can be shut down from 2026-06-01, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.6-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.0-flash` | February 5, 2025 | June 1, 2026 | `gemini-3.6-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 15, + "fingerprint": "sha256:83b2140ac7dce78acb6a4338e680fefed3069e978f060b707b965b078746b345", + "api": "google/gemini-models", + "version": "2026-06-01", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.0-flash-001", + "replacement": "gemini-3.6-flash" + }, + "description": "Model \"gemini-2.0-flash-001\" can be shut down from 2026-06-01, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.6-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.0-flash-001` | February 5, 2025 | June 1, 2026 | `gemini-3.6-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 16, + "fingerprint": "sha256:606afbea818c0aa70a918ce8a161373fc742c491a4c591180ce32e582e7271a6", + "api": "google/gemini-models", + "version": "2026-06-01", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.0-flash-lite", + "replacement": "gemini-3.5-flash-lite" + }, + "description": "Model \"gemini-2.0-flash-lite\" can be shut down from 2026-06-01, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.5-flash-lite` instead: Google's recommended replacement. (Google first named gemini-3.1-flash-lite, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.0-flash-lite` | February 25, 2025 | June 1, 2026 | `gemini-3.1-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 17, + "fingerprint": "sha256:c46f075bda7582cef7ad8fb25fda10b4412029124b68f67aa3aae129cb26fb54", + "api": "google/gemini-models", + "version": "2026-06-01", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.0-flash-lite-001", + "replacement": "gemini-3.5-flash-lite" + }, + "description": "Model \"gemini-2.0-flash-lite-001\" can be shut down from 2026-06-01, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.5-flash-lite` instead: Google's recommended replacement. (Google first named gemini-3.1-flash-lite, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.0-flash-lite-001` | February 25, 2025 | June 1, 2026 | `gemini-3.1-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 18, + "fingerprint": "sha256:f33c6d97b86cb936d566061674c549260c611d3084532190e53ede81a667cb64", + "api": "google/gemini-models", + "version": "2025-12-09", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.0-flash-lite-preview", + "replacement": "gemini-3.5-flash-lite" + }, + "description": "Model \"gemini-2.0-flash-lite-preview\" can be shut down from 2025-12-09, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.5-flash-lite` instead: Google's recommended replacement. (Google first named gemini-3.1-flash-lite, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.0-flash-lite-preview` | February 5, 2025 | December 9, 2025 | `gemini-3.1-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 19, + "fingerprint": "sha256:1905e464a0c97bc4e0adc0812fe8f9e578f239fe86d263dbd8ea112ecd669cf8", + "api": "google/gemini-models", + "version": "2025-12-09", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.0-flash-lite-preview-02-05", + "replacement": "gemini-3.5-flash-lite" + }, + "description": "Model \"gemini-2.0-flash-lite-preview-02-05\" can be shut down from 2025-12-09, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.5-flash-lite` instead: Google's recommended replacement. (Google first named gemini-3.1-flash-lite, which is itself retired.)", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.0-flash-lite-preview-02-05` | February 5, 2025 | December 9, 2025 | `gemini-3.1-flash-lite` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 20, + "fingerprint": "sha256:7b91dbf1e5b957702a1f2e048ff346070c9765f96ec23c6cf018562a7391c15f", + "api": "google/gemini-models", + "version": "2027-03-31", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-flash-native-audio-preview-12-2025", + "replacement": "gemini-3.8-live" + }, + "description": "Model \"gemini-2.5-flash-native-audio-preview-12-2025\" can be shut down from 2027-03-31, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.8-live` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Preview models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-flash-native-audio-preview-12-2025` | December 12, 2025 | March 31, 2027 | `gemini-3.8-live` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 21, + "fingerprint": "sha256:b3d90322199ab4367fc8eba144f8cd88b5a5c3b786a7374d159a2332d9f5244c", + "api": "google/gemini-models", + "version": "2025-12-09", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-live-2.5-flash-preview", + "replacement": "gemini-3.8-live" + }, + "description": "Model \"gemini-live-2.5-flash-preview\" can be shut down from 2025-12-09, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.8-live` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-live-2.5-flash-preview` | June 17, 2025 | December 9, 2025 | `gemini-3.8-live` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 22, + "fingerprint": "sha256:840b70b0db6e2eb215e8266fe0105f25a0855d32aba42a776523c0fd0d8a4e52", + "api": "google/gemini-models", + "version": "2025-12-09", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.0-flash-live-001", + "replacement": "gemini-3.8-live" + }, + "description": "Model \"gemini-2.0-flash-live-001\" can be shut down from 2025-12-09, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.8-live` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.0-flash-live-001` | April 9, 2025 | December 9, 2025 | `gemini-3.8-live` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 23, + "fingerprint": "sha256:a6a20dbe9b625f444a1644e3c8ccbce9a63ebfa4e039393c75633c8ca4b13974", + "api": "google/gemini-models", + "version": "2026-12-18", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-flash-preview-tts" + }, + "description": "Model \"gemini-2.5-flash-preview-tts\" can be shut down from 2026-12-18, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.8-flash-tts` or `gemini-3.8-flash-lite-tts` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Preview models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-flash-preview-tts` | May 20, 2025 | December 18, 2026 | `gemini-3.8-flash-tts` or `gemini-3.8-flash-lite-tts` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 24, + "fingerprint": "sha256:8bc72c3cc1260e614977f305a2c61bee114dd67ec702fff60f09a036232e2a97", + "api": "google/gemini-models", + "version": "2026-12-18", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-pro-preview-tts" + }, + "description": "Model \"gemini-2.5-pro-preview-tts\" can be shut down from 2026-12-18, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.8-flash-tts` or `gemini-3.8-flash-lite-tts` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Preview models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-pro-preview-tts` | May 20, 2025 | December 18, 2026 | `gemini-3.8-flash-tts` or `gemini-3.8-flash-lite-tts` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 25, + "fingerprint": "sha256:6c676c8e23b7b1d9db5de5e998a741c6fbac7dc2c2bf1929b647e7f6cf680542", + "api": "google/gemini-models", + "version": "2028-05-14", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-embedding-001", + "replacement": "gemini-embedding-2" + }, + "description": "Model \"gemini-embedding-001\" can be shut down from 2028-05-14, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-embedding-2` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "## Embedding models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-embedding-001` | July 14, 2025 | May 14, 2028 | `gemini-embedding-2` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 26, + "fingerprint": "sha256:f78e21e24ec4d3f9122c2631190b6b92736ec1bd89010b63b209bf2507daf953", + "api": "google/gemini-models", + "version": "2026-11-06", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-embedding-2-preview" + }, + "description": "Model \"gemini-embedding-2-preview\" can be shut down from 2026-11-06, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-embedding-2` (effective November 6, 2026, API requests to `gemini-embedding-2-preview` route to `gemini-embedding-2`) instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-embedding-2-preview` | March 10, 2026 | November 6, 2026 | `gemini-embedding-2` (effective November 6, 2026, API requests to `gemini-embedding-2-preview` route to `gemini-embedding-2`) |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 27, + "fingerprint": "sha256:0a968f052281aeb0c8cd71d3a92db497be8040686f23c3d592f6406aea39d68f", + "api": "google/gemini-models", + "version": "2026-01-14", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "text-embedding-004", + "replacement": "gemini-embedding-2" + }, + "description": "Model \"text-embedding-004\" can be shut down from 2026-01-14, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-embedding-2` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `text-embedding-004` | April 9, 2024 | January 14, 2026 | `gemini-embedding-2` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 28, + "fingerprint": "sha256:d1332b877be37336a413687d6be1480cf66dcfb3369101147a88c216a58e0736", + "api": "google/gemini-models", + "version": "2025-10-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "embedding-001", + "replacement": "gemini-embedding-2" + }, + "description": "Model \"embedding-001\" can be shut down from 2025-10-30, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-embedding-2` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `embedding-001` | April 9, 2024 | October 30, 2025 | `gemini-embedding-2` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 29, + "fingerprint": "sha256:9961f36c881a0bdf2d339315acd7895323e3b4672b0957436987f3b1c8296b2f", + "api": "google/gemini-models", + "version": "2025-10-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "embedding-gecko-001", + "replacement": "gemini-embedding-2" + }, + "description": "Model \"embedding-gecko-001\" can be shut down from 2025-10-30, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-embedding-2` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `embedding-gecko-001` | | October 30, 2025 | `gemini-embedding-2` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 30, + "fingerprint": "sha256:49b126de93982f83c2ee88f884ad720f1d0921206dae42f5826227db76af68ee", + "api": "google/gemini-models", + "version": "2025-10-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-embedding-exp", + "replacement": "gemini-embedding-2" + }, + "description": "Model \"gemini-embedding-exp\" can be shut down from 2025-10-30, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-embedding-2` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-embedding-exp` | | October 30, 2025 | `gemini-embedding-2` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 31, + "fingerprint": "sha256:ef27905e81e0ee48ec07d4669a42ea6ce0dd785a7f85033d7e1d34d7bf411b94", + "api": "google/gemini-models", + "version": "2025-10-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-embedding-exp-03-07", + "replacement": "gemini-embedding-2" + }, + "description": "Model \"gemini-embedding-exp-03-07\" can be shut down from 2025-10-30, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-embedding-2` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-embedding-exp-03-07` | | October 30, 2025 | `gemini-embedding-2` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 32, + "fingerprint": "sha256:acc61a0a44b398c42fb63c271aa2163a03749d76b12932f561f303c4981ae96e", + "api": "google/gemini-models", + "version": "2027-03-15", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-flash-image", + "replacement": "gemini-3.1-flash-lite-image" + }, + "description": "Model \"gemini-2.5-flash-image\" can be shut down from 2027-03-15, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3.1-flash-lite-image` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "## Nano Banana models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-flash-image` | October 2, 2025 | March 15, 2027 | `gemini-3.1-flash-lite-image` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 33, + "fingerprint": "sha256:352f204e72c7ab36bb05cb742c9edee87f1589930ece2bc90ffbb851c443aba7", + "api": "google/gemini-models", + "version": "2026-06-25", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-3.1-flash-image-preview", + "replacement": "gemini-nano-banana-2.1" + }, + "description": "Model \"gemini-3.1-flash-image-preview\" can be shut down from 2026-06-25, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-nano-banana-2.1` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-3.1-flash-image-preview` | February 26, 2026 | June 25, 2026 | `gemini-nano-banana-2.1` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 34, + "fingerprint": "sha256:1d09afffb5768ce989c65f94befc597bdba8a13131ad7c2cc139741a1b39bf56", + "api": "google/gemini-models", + "version": "2026-06-25", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-3-pro-image-preview", + "replacement": "gemini-3-pro-image" + }, + "description": "Model \"gemini-3-pro-image-preview\" can be shut down from 2026-06-25, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-3-pro-image` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-3-pro-image-preview` | November 20, 2025 | June 25, 2026 | `gemini-3-pro-image` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 35, + "fingerprint": "sha256:9132c7b110d46a16200f6541ece38bcbe0748e75d36c1bd3586eab10398fbe37", + "api": "google/gemini-models", + "version": "2026-01-15", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.5-flash-image-preview", + "replacement": "gemini-nano-banana-2.1" + }, + "description": "Model \"gemini-2.5-flash-image-preview\" can be shut down from 2026-01-15, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-nano-banana-2.1` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.5-flash-image-preview` | May 7, 2025 | January 15, 2026 | `gemini-nano-banana-2.1` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 36, + "fingerprint": "sha256:c42e560875145b4013adeac0199e6ee63421d16e345ee97c023565710c4f3215", + "api": "google/gemini-models", + "version": "2025-11-14", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-2.0-flash-preview-image-generation", + "replacement": "gemini-nano-banana-2.1" + }, + "description": "Model \"gemini-2.0-flash-preview-image-generation\" can be shut down from 2025-11-14, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-nano-banana-2.1` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-2.0-flash-preview-image-generation` | May 7, 2025 | November 14, 2025 | `gemini-nano-banana-2.1` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 37, + "fingerprint": "sha256:c889c0a9533b444eda90a0d8d057d30a837941242dfaa095a5378027d6579654", + "api": "google/gemini-models", + "version": "2026-08-17", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagen-4.0-generate-001", + "replacement": "gemini-nano-banana-2.1" + }, + "description": "Model \"imagen-4.0-generate-001\" can be shut down from 2026-08-17, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-nano-banana-2.1` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `imagen-4.0-generate-001` | June 24, 2025 | August 17, 2026 | `gemini-nano-banana-2.1` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 38, + "fingerprint": "sha256:b65d181909243d2cfdbcf4a81fea4fa279eacdb61e776b235685042b1d273da4", + "api": "google/gemini-models", + "version": "2026-08-17", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagen-4.0-ultra-generate-001", + "replacement": "gemini-nano-banana-2.1" + }, + "description": "Model \"imagen-4.0-ultra-generate-001\" can be shut down from 2026-08-17, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-nano-banana-2.1` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `imagen-4.0-ultra-generate-001` | June 24, 2025 | August 17, 2026 | `gemini-nano-banana-2.1` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 39, + "fingerprint": "sha256:8a703192637bc96b8f7a341b9ef30531bd5bb58dd26c89e4fd938dd9834daaa4", + "api": "google/gemini-models", + "version": "2026-08-17", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagen-4.0-fast-generate-001", + "replacement": "gemini-nano-banana-2.1" + }, + "description": "Model \"imagen-4.0-fast-generate-001\" can be shut down from 2026-08-17, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-nano-banana-2.1` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `imagen-4.0-fast-generate-001` | June 24, 2025 | August 17, 2026 | `gemini-nano-banana-2.1` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 40, + "fingerprint": "sha256:03f79598c1d1c60b2390af7583c7346dc18c2cacc9116a52d1d1e4f575c6d070", + "api": "google/gemini-models", + "version": "2026-02-17", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagen-4.0-generate-preview-06-06", + "replacement": "gemini-nano-banana-2.1" + }, + "description": "Model \"imagen-4.0-generate-preview-06-06\" can be shut down from 2026-02-17, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-nano-banana-2.1` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `imagen-4.0-generate-preview-06-06` | June 24, 2025 | February 17, 2026 | `gemini-nano-banana-2.1` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 41, + "fingerprint": "sha256:4e1ece623c8fc9d8f782fc8b9c1bc5c27904204d0cffa5e5369098ba245124e1", + "api": "google/gemini-models", + "version": "2026-02-17", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagen-4.0-ultra-generate-preview-06-06", + "replacement": "gemini-nano-banana-2.1" + }, + "description": "Model \"imagen-4.0-ultra-generate-preview-06-06\" can be shut down from 2026-02-17, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-nano-banana-2.1` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `imagen-4.0-ultra-generate-preview-06-06` | June 24, 2025 | February 17, 2026 | `gemini-nano-banana-2.1` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 42, + "fingerprint": "sha256:7855e31da95e666c348f96b9ccfbc5e353c3c0c0713553ddbae260d29ebded13", + "api": "google/gemini-models", + "version": "2025-11-10", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "imagen-3.0-generate-002", + "replacement": "gemini-nano-banana-2.1" + }, + "description": "Model \"imagen-3.0-generate-002\" can be shut down from 2025-11-10, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-nano-banana-2.1` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `imagen-3.0-generate-002` | February 6, 2025 | November 10, 2025 | `gemini-nano-banana-2.1` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 43, + "fingerprint": "sha256:f4406ae5b26f233d65b6f39e0a4c99868f125bbea55dc703938ca776d8ec633b", + "api": "google/gemini-models", + "version": "2026-10-22", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "veo-3.1-lite-generate-preview", + "replacement": "gemini-omni-1.2-flash" + }, + "description": "Model \"veo-3.1-lite-generate-preview\" can be shut down from 2026-10-22, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-omni-1.2-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `veo-3.1-lite-generate-preview` | March 31, 2026 | October 22, 2026 | `gemini-omni-1.2-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 44, + "fingerprint": "sha256:8554aabbaf268ea7946f6a3e686c1157fbff2a57997d35773f1fbf46bec5afc0", + "api": "google/gemini-models", + "version": "2026-10-22", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "veo-3.1-generate-preview", + "replacement": "gemini-omni-1.2-flash" + }, + "description": "Model \"veo-3.1-generate-preview\" can be shut down from 2026-10-22, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-omni-1.2-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `veo-3.1-generate-preview` | October 15, 2025 | October 22, 2026 | `gemini-omni-1.2-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 45, + "fingerprint": "sha256:0a83cb678a880fb7254c61aec5e1b0e0ba19aa5435d956156d5459eddbe9be4c", + "api": "google/gemini-models", + "version": "2026-10-22", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "veo-3.1-fast-generate-preview", + "replacement": "gemini-omni-1.2-flash" + }, + "description": "Model \"veo-3.1-fast-generate-preview\" can be shut down from 2026-10-22, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-omni-1.2-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `veo-3.1-fast-generate-preview` | October 15, 2025 | October 22, 2026 | `gemini-omni-1.2-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 46, + "fingerprint": "sha256:9ae0db34527de17bb0383edde0172525ec9032cf2a5cdac0df7af07f7c303668", + "api": "google/gemini-models", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "veo-3.0-generate-001" + }, + "description": "Model \"veo-3.0-generate-001\" can be shut down from 2026-06-30, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-omni-1.2-flash` or the GA models on the [Gemini Enterprise Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/veo/3-1-generate) instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `veo-3.0-generate-001` | September 9, 2025 | June 30, 2026 | `gemini-omni-1.2-flash` or the GA models on the [Gemini Enterprise Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/veo/3-1-generate) |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 47, + "fingerprint": "sha256:3a692dac54bbd0875feefbf6a8135be447fa904017da920eb1dc6d30e0f1d86a", + "api": "google/gemini-models", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "veo-3.0-fast-generate-001" + }, + "description": "Model \"veo-3.0-fast-generate-001\" can be shut down from 2026-06-30, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-omni-1.2-flash` or the GA models on the [Gemini Enterprise Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/veo/3-1-generate) instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `veo-3.0-fast-generate-001` | September 9, 2025 | June 30, 2026 | `gemini-omni-1.2-flash` or the GA models on the [Gemini Enterprise Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/veo/3-1-generate) |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 48, + "fingerprint": "sha256:a394fe9fdeeb5a404f2c0b561439c7236477e7fc837927962ab3aa5db1f896d5", + "api": "google/gemini-models", + "version": "2026-06-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "veo-2.0-generate-001" + }, + "description": "Model \"veo-2.0-generate-001\" can be shut down from 2026-06-30, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-omni-1.2-flash` or the GA models on the [Gemini Enterprise Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/veo/3-1-generate) instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `veo-2.0-generate-001` | April 9, 2025 | June 30, 2026 | `gemini-omni-1.2-flash` or the GA models on the [Gemini Enterprise Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/veo/3-1-generate) |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 49, + "fingerprint": "sha256:ab74adbe95ffded3bd489bbd60695d9d94948d636f8e60daac190561b6474a19", + "api": "google/gemini-models", + "version": "2025-11-12", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "veo-3.0-generate-preview", + "replacement": "gemini-omni-1.2-flash" + }, + "description": "Model \"veo-3.0-generate-preview\" can be shut down from 2025-11-12, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-omni-1.2-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `veo-3.0-generate-preview` | July 31, 2025 | November 12, 2025 | `gemini-omni-1.2-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 50, + "fingerprint": "sha256:0f5636525a0226794daa38aa43146d185121082d0eac106e9d875b8b991d1b91", + "api": "google/gemini-models", + "version": "2025-11-12", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "veo-3.0-fast-generate-preview", + "replacement": "gemini-omni-1.2-flash" + }, + "description": "Model \"veo-3.0-fast-generate-preview\" can be shut down from 2025-11-12, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-omni-1.2-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `veo-3.0-fast-generate-preview` | July 31, 2025 | November 12, 2025 | `gemini-omni-1.2-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 51, + "fingerprint": "sha256:32849db67ffe3564cf53e5d5b56a8536949a7fd3aa6cb28223c0bd8656ee4e7e", + "api": "google/gemini-models", + "version": "2026-12-03", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-omni-1.1-flash" + }, + "description": "Model \"gemini-omni-1.1-flash\" can be shut down from 2026-12-03, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-omni-1.2-flash` (Effective December 3, 2026, the endpoint is automatically routing API requests to `gemini-omni-1.2-flash`) instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "## Gemini Omni Flash models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-omni-1.1-flash` | August 27, 2026 | December 3, 2026 | `gemini-omni-1.2-flash` (Effective December 3, 2026, the endpoint is automatically routing API requests to `gemini-omni-1.2-flash`) |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 52, + "fingerprint": "sha256:6b6d10f0220a8da62121f3ed15db742d6f8bbdd987db4671ee04709957275efc", + "api": "google/gemini-models", + "version": "2026-10-22", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-omni-flash-preview", + "replacement": "gemini-omni-1.2-flash" + }, + "description": "Model \"gemini-omni-flash-preview\" can be shut down from 2026-10-22, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-omni-1.2-flash` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-omni-flash-preview` | June 30, 2026 | October 22, 2026 | `gemini-omni-1.2-flash` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 53, + "fingerprint": "sha256:54a233efe659c23ad8898c69d4d211f7e48aa36acbd16fadb14a3547a6f3daf4", + "api": "google/gemini-models", + "version": "2026-08-31", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-robotics-er-1.6-preview", + "replacement": "gemini-robotics-er-2-preview" + }, + "description": "Model \"gemini-robotics-er-1.6-preview\" can be shut down from 2026-08-31, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-robotics-er-2-preview` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-robotics-er-1.6-preview` | April 14, 2026 | August 31, 2026 | `gemini-robotics-er-2-preview` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 54, + "fingerprint": "sha256:0a9481a7ed1278252e1175f2555423a03b83d4680e42f075558914f3ef3e2e5b", + "api": "google/gemini-models", + "version": "2026-04-30", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "model", + "provider": "google", + "name": "gemini-robotics-er-1.5-preview", + "replacement": "gemini-robotics-er-2-preview" + }, + "description": "Model \"gemini-robotics-er-1.5-preview\" can be shut down from 2026-04-30, the earliest date Google gives: Google requests naming it fail once it is.", + "migration_hint": "Use `gemini-robotics-er-2-preview` instead: Google's recommended replacement.", + "source_url": "https://web.archive.org/web/20261114120000/https://aistudio.google.com/docs/deprecations", + "source_excerpt": "### Deprecated models\n| Model | Release date | Shutdown date | Recommended replacement |\n| `gemini-robotics-er-1.5-preview` | September 25, 2025 | April 30, 2026 | `gemini-robotics-er-2-preview` |", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + } +] diff --git a/providers/google-gemini-models.md b/providers/google-gemini-models.md new file mode 100644 index 0000000..db38479 --- /dev/null +++ b/providers/google-gemini-models.md @@ -0,0 +1,33 @@ +# Google Gemini API models (`google/gemini-models`) + +## What it watches + +Gemini API models Google shuts down: every model on Google's own Gemini API deprecations page with a shutdown date, one `model` event per model name, with the replacement Google recommends. Google gives each date as the earliest a model may be shut down; the event says so. + +Kind: `notices` (`plugins/notices`), with the deprecations-table reader (`plugins/notices/retire`, `retire.Gemini`), reading Markdoc tables. + +## Why this source + +- **Source:** [Gemini deprecations](https://ai.google.dev/gemini-api/docs/deprecations), which redirects to `https://aistudio.google.com/docs/deprecations`; that URL serves the page as Markdown (Markdoc `{% table %}` blocks), and the plugin reads it there. Checked on 2026-11-21. +- **Why this one:** it's Google's own table of every Gemini API model with its release date, its shutdown date and the recommended replacement, one table per model family, the shut-down ones kept under "Deprecated models". It's where Google says deprecation dates are tracked: "Deprecation announcements are made on the Release notes page, and the announced earliest shutdown dates are tracked on this page." +- **Alternatives considered:** + - **The Gemini API release notes** (`https://aistudio.google.com/docs/changelog`): the same deprecations, announced in prose, one entry per day. The table is the same facts, already structured. + - **Vertex AI's model versions page**: the same models on Google Cloud, with Google Cloud's own retirement dates, which differ from the Gemini API's (gemini-2.5-pro: 2026-10-20 on Vertex AI, 2026-12-01 here). A separate source: a repo reaches one or the other. + - **The Gemini API's models list** (`GET /v1beta/models`): what's served now, with no dates. +- **Quote:** "| `gemini-2.0-flash` | February 5, 2025 | June 1, 2026 | `gemini-3.6-flash` |" (Gemini 2.0 models, Deprecated models), and above the tables: "The shutdown dates listed in the table indicate the earliest possible dates on which a model might be retired". + +## How the provider announces changes + +- Models are named by version (`gemini-2.5-flash`, `gemini-2.5-flash-preview-09-2025`); a preview gets a shutdown date months after its stable model ships, a stable model about a year after its successor. +- A model is announced in the release notes, then its date appears here. Some shut-down models' requests are routed to a successor ("effective December 1, 2026, API requests to `gemini-2.5-pro` will automatically route to `gemini-3.8-flash`"); the replacement cell says so, and the hint quotes it. + +## What the plugin reads and ignores + +- Reads every Markdoc table with a "Shutdown date", a "Model" and a "Recommended replacement" column: one `breaking` `model` event per model name with a date, `version` the date. `replacement` is set when the cell names exactly one plain model; otherwise the hint quotes the cell. +- Ignores a row whose date isn't a date ("No shutdown date announced"), the managed agents' tables (an "Agent" column, not a model), and a cell that isn't a plain model id (a footnote mark). The pinned drop test: the Gemini 4 models and the agents, next to the two shut-down Gemini 3 previews, give only those two events. +- A read with far fewer models than the last one fails (the table changed shape), as do a page with no table and a block page. + +## Known gaps + +- Google's dates are the earliest possible; a later exact date only shows up when Google edits the row, which is then a new event. +- Models served only on Vertex AI are the other source's.