# Gemini models — catalogue (Gemini Developer API)

**Status:** DOCUMENTED + LIVE_DISCOVERED (58 ids via paginated `GET /v1beta/models`, 22 via `GET /v1/models`) + LIVE_VERIFIED for the ids probed on 2026-09-19 (see `verification` per record). Machine-readable twin: `generated/fragments/models/gemini-models.json` (97 records: 58 live + 39 documented-only/retired). This page is **generated** by `scripts/gen_gemini_models_fragment.py` — edit the script, not this file.

**Sources:** https://ai.google.dev/gemini-api/docs/models · model pages `…/docs/models/<id>` · https://ai.google.dev/api/models · https://ai.google.dev/gemini-api/docs/pricing · https://ai.google.dev/gemini-api/docs/deprecations · https://ai.google.dev/gemini-api/docs/rate-limits · https://ai.google.dev/gemini-api/docs/thinking · https://ai.google.dev/gemini-api/docs/api-versions · discovery document revision 20260918.

**Last verified:** 2026-09-18 (docs) / 2026-09-19 UTC (live). Related: [pricing](../gemini/pricing.md) · [rate limits](../gemini/rate-limits.md) · [deprecations & changelog](../gemini/deprecations-and-changelog.md) · [auth / headers / versions](../gemini/authentication-headers-versions.md) · [errors](../errors/gemini.md) · [SDKs](../gemini/sdks.md) · [OpenAI compatibility](../gemini/openai-compatibility.md) · [Gemini index](../gemini/index.md)

## 1. Families and naming

| Family | Live ids (2026-09-19) | Notes |
|---|---|---|
| Gemini 2.5 | `gemini-2.5-flash`, `gemini-2.5-pro`, `gemini-2.5-flash-preview-tts`, `gemini-2.5-pro-preview-tts`, `gemini-2.5-flash-lite`, `gemini-2.5-flash-image`, `gemini-2.5-computer-use-preview-10-2025`, `gemini-2.5-flash-native-audio-preview-09-2025`, `gemini-2.5-flash-native-audio-preview-12-2025` | 9 ids |
| Gemma 4 | `gemma-4-26b-a4b-it`, `gemma-4-31b-it` | 2 ids |
| Gemini (latest alias) | `gemini-flash-latest`, `gemini-flash-lite-latest`, `gemini-pro-latest`, `gemini-2.5-flash-native-audio-latest` | 4 ids |
| Gemini 3 | `gemini-3-flash-preview`, `gemini-3-pro-image-preview`, `gemini-3-pro-image` | 3 ids |
| Gemini 3.1 | `gemini-3.1-pro-preview`, `gemini-3.1-pro-preview-customtools`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.1-flash-image-preview`, `gemini-3.1-flash-image`, `gemini-3.1-flash-lite-image`, `gemini-3.1-flash-tts-preview`, `gemini-3.1-flash-live-preview` | 9 ids |
| Gemini 3 (image) | `nano-banana-pro-preview` | 1 ids |
| Gemini 3.5 | `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.5-transcribe`, `gemini-3.5-transcribe-live`, `gemini-3.5-live-translate-preview` | 5 ids |
| Gemini Omni | `gemini-omni-flash-preview`, `gemini-omni-1.1-flash` | 2 ids |
| Gemini 3.6 | `gemini-3.6-flash` | 1 ids |
| Gemini 3.7 | `gemini-3.7-flash` | 1 ids |
| Gemini 3.8 | `gemini-3.8-flash`, `gemini-3.8-live`, `gemini-3.8-live-extended-thinking` | 3 ids |
| Lyria | `lyria-3-clip-preview`, `lyria-3-pro-preview`, `lyria-3.5`, `lyria-realtime-exp` | 4 ids |
| Gemini Robotics-ER | `gemini-robotics-er-2-preview`, `gemini-robotics-er-2-streaming-preview` | 2 ids |
| Antigravity (managed agent) | `antigravity-preview-05-2026`, `antigravity-preview-09-2026` | 2 ids |
| Deep Research (agent) | `deep-research-max-preview-04-2026`, `deep-research-preview-04-2026`, `deep-research-pro-preview-12-2025` | 3 ids |
| Gemini Embedding | `gemini-embedding-001`, `gemini-embedding-2-preview`, `gemini-embedding-2` | 3 ids |
| AQA (Attributed Question Answering) | `aqa` | 1 ids |
| Veo | `veo-3.1-generate-preview`, `veo-3.1-fast-generate-preview`, `veo-3.1-lite-generate-preview` | 3 ids |

Naming patterns (models.md, convention since Sept 2025): **stable** `gemini-3.6-flash`; **preview** `gemini-3.1-pro-preview` / dated `…-preview-09-2025` (billing on, tighter limits, ≥2 weeks deprecation notice); **latest** aliases `gemini-flash-latest`, `gemini-pro-latest`, `gemini-flash-lite-latest`, `gemini-2.5-flash-native-audio-latest` (hot-swapped, 2-week e-mail notice for breaking changes); **experimental** `lyria-realtime-exp` (no production use). Live `version` strings are inconsistent: dated (`3.7-flash-08-2026`), bare (`3.0` for gemini-3.8-flash and all image models), or the display name (`Gemini Flash Latest`).

### Alias resolution observed

| Alias | Resolves to (live) | Evidence |
|---|---|---|
| `gemini-flash-latest` | gemini-3.8-flash | generateContent modelVersion=gemini-3.8-flash (2026-09-19) |
| `gemini-pro-latest` | gemini-3.1-pro (quota dimension model=gemini-3.1-pro in the 429 body) | 429 RESOURCE_EXHAUSTED free-tier limit 0, quotaDimensions.model=gemini-3.1-pro (2026-09-19) |
| `gemini-flash-lite-latest` | unknown (not probed) | GET 200; description 'Latest release of Gemini Flash-Lite' |
| `gemini-2.5-flash-native-audio-latest` | unknown (Live API only, not probed) | GET /v1beta/models listing |

`gemini-3-pro-preview` was shut down 2026-03-09 and per the changelog 'now points to gemini-3.1-pro-preview'; live `GET` still returns `version: 3-pro-preview-11-2025`. `nano-banana-pro-preview` is the same live object as `gemini-3-pro-image-preview` (version 3.0, display name Nano Banana Pro). `gemini-3.1-pro-preview-customtools` is a variant endpoint of `gemini-3.1-pro-preview` (same version `3.1-pro-preview-01-2026`) tuned to prefer custom tools.

## 2. Live catalogue (58 ids) — limits, lifecycle, verification

| id | Display name | Kind | Status | In / Out tokens (live) | Thinking (live flag / docs default) | Release | Shutdown | Verified |
|---|---|---|---|---|---|---|---|---|
| `gemini-2.5-flash` | Gemini 2.5 Flash | stable | DOCUMENTED, LIVE_DISCOVERED | 1,048,576 / 65,536 | True / on (dynamic budget) | 2025-06-17 | - |  |
| `gemini-2.5-pro` | Gemini 2.5 Pro | stable | DOCUMENTED, LIVE_DISCOVERED | 1,048,576 / 65,536 | True / on (dynamic budget) | 2025-06-17 | - |  |
| `gemini-2.5-flash-preview-tts` | Gemini 2.5 Flash Preview TTS | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 8,192 / 16,384 | None / unknown | 2025-05-20 | - |  |
| `gemini-2.5-pro-preview-tts` | Gemini 2.5 Pro Preview TTS | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 8,192 / 16,384 | None / unknown | 2025-05-20 | - |  |
| `gemma-4-26b-a4b-it` | Gemma 4 26B A4B IT | stable | DOCUMENTED, LIVE_DISCOVERED, LIVE_VERIFIED | 262,144 / 32,768 | True / unknown | 2026-04-02 | - | GET /v1beta/models/gemma-4-26b-a4b-it -> 200; POST :generateContent -> 200 (modelVersion=gemma-4-26b-a4b-it) |
| `gemma-4-31b-it` | Gemma 4 31B IT | stable | DOCUMENTED, LIVE_DISCOVERED | 262,144 / 32,768 | True / unknown | 2026-04-02 | - |  |
| `gemini-flash-latest` | Gemini Flash Latest | alias | DOCUMENTED, LIVE_DISCOVERED, LIVE_VERIFIED | 1,048,576 / 65,536 | True / unknown | ? | - | GET /v1beta/models/gemini-flash-latest -> 200; POST :generateContent -> 200 (modelVersion=gemini-3.8-flash) |
| `gemini-flash-lite-latest` | Gemini Flash-Lite Latest | alias | DOCUMENTED, LIVE_DISCOVERED, LIVE_VERIFIED | 1,048,576 / 65,536 | True / unknown | ? | - | GET /v1beta/models/gemini-flash-lite-latest -> 200 |
| `gemini-pro-latest` | Gemini Pro Latest | alias | DOCUMENTED, LIVE_DISCOVERED, ACCOUNT_RESTRICTED | 1,048,576 / 65,536 | True / unknown | ? | - | GET /v1beta/models/gemini-pro-latest -> 200; POST :generateContent -> 429 RESOURCE_EXHAUSTED |
| `gemini-2.5-flash-lite` | Gemini 2.5 Flash-Lite | stable | DOCUMENTED, LIVE_DISCOVERED, ACCOUNT_RESTRICTED | 1,048,576 / 65,536 | True / off | 2025-07-22 | - | GET /v1beta/models/gemini-2.5-flash-lite -> 200; POST :generateContent -> 404 NOT_FOUND |
| `gemini-2.5-flash-image` | Nano Banana | stable | DOCUMENTED, LIVE_DISCOVERED, DEPRECATED | 32,768 / 32,768 | None / unknown | 2025-10-02 | 2026-10-02 |  |
| `gemini-3-flash-preview` | Gemini 3 Flash Preview | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 1,048,576 / 65,536 | True / high | 2025-12-17 | - |  |
| `gemini-3.1-pro-preview` | Gemini 3.1 Pro Preview | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW, ACCOUNT_RESTRICTED | 1,048,576 / 65,536 | True / high | 2026-02-19 | - | POST :generateContent -> 429 RESOURCE_EXHAUSTED |
| `gemini-3.1-pro-preview-customtools` | Gemini 3.1 Pro Preview Custom Tools | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 1,048,576 / 65,536 | True / high | 2026-02-19 | - |  |
| `gemini-3.1-flash-lite-preview` | Gemini 3.1 Flash Lite Preview | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW, RETIRED | 1,048,576 / 65,536 | True / unknown | 2026-03-03 | 2026-05-25 |  |
| `gemini-3.1-flash-lite` | Gemini 3.1 Flash Lite | stable | DOCUMENTED, LIVE_DISCOVERED, DEPRECATED | 1,048,576 / 65,536 | True / unknown (docs table omits it; openai.md maps minimal/low/medium/high) | 2026-05-07 | 2027-05-07 |  |
| `gemini-3-pro-image-preview` | Nano Banana Pro | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW, RETIRED | 131,072 / 32,768 | True / unknown | 2025-11-20 | 2026-06-25 |  |
| `gemini-3-pro-image` | Nano Banana Pro | stable | DOCUMENTED, LIVE_DISCOVERED | 131,072 / 32,768 | True / unknown | 2026-05-28 | - |  |
| `nano-banana-pro-preview` | Nano Banana Pro | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW, RETIRED | 131,072 / 32,768 | True / unknown | 2025-11-20 | 2026-06-25 |  |
| `gemini-3.1-flash-image-preview` | Nano Banana 2 | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW, RETIRED | 65,536 / 65,536 | True / unknown | 2026-02-26 | 2026-06-25 |  |
| `gemini-3.1-flash-image` | Nano Banana 2 | stable | DOCUMENTED, LIVE_DISCOVERED | 65,536 / 65,536 | True / unknown | 2026-05-28 | - |  |
| `gemini-3.1-flash-lite-image` | Nano Banana 2 Lite | stable | DOCUMENTED, LIVE_DISCOVERED | 65,536 / 65,536 | True / minimal | 2026-06-30 | - |  |
| `gemini-3.5-flash` | Gemini 3.5 Flash | stable | DOCUMENTED, LIVE_DISCOVERED, LIVE_VERIFIED | 1,048,576 / 65,536 | True / medium | 2026-05-19 | - | POST :generateContent -> 200 (modelVersion=gemini-3.5-flash) |
| `gemini-3.5-flash-lite` | Gemini 3.5 Flash Lite | stable | DOCUMENTED, LIVE_DISCOVERED, LIVE_VERIFIED | 1,048,576 / 65,536 | True / minimal | 2026-07-21 | - | GET /v1beta/models/gemini-3.5-flash-lite -> 200; POST :generateContent -> 200 (modelVersion=gemini-3.5-flash-lite) |
| `gemini-omni-flash-preview` | Gemini Omni Flash Preview | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW, DEPRECATED | 131,072 / 65,536 | True / unknown | 2026-06-30 | 2026-09-30 |  |
| `gemini-omni-1.1-flash` | Gemini Omni 1.1 Flash | stable | DOCUMENTED, LIVE_DISCOVERED | 131,072 / 65,536 | True / unknown | 2026-08-27 | - |  |
| `gemini-3.5-transcribe` | Gemini 3.5 Transcribe | stable | DOCUMENTED, LIVE_DISCOVERED | 98,304 / 32,768 | True / unknown | 2026-08 | - |  |
| `gemini-3.6-flash` | Gemini 3.6 Flash | stable | DOCUMENTED, LIVE_DISCOVERED | 1,048,576 / 65,536 | True / medium | 2026-07-21 | - |  |
| `gemini-3.7-flash` | Gemini 3.7 Flash | stable | DOCUMENTED, LIVE_DISCOVERED | 1,048,576 / 65,536 | True / medium | 2026-08-13 | - |  |
| `gemini-3.8-flash` | Gemini 3.8 Flash | stable | DOCUMENTED, LIVE_DISCOVERED, LIVE_VERIFIED | 1,048,576 / 65,536 | True / medium | 2026-09-02 | - | POST :generateContent -> 200 (modelVersion=gemini-3.8-flash) |
| `lyria-3-clip-preview` | Lyria 3 Clip Preview | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 1,048,576 / 65,536 | None / unknown | 2026-03-25 | - |  |
| `lyria-3-pro-preview` | Lyria 3 Pro Preview | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 1,048,576 / 65,536 | None / unknown | 2026-03-25 | - |  |
| `lyria-3.5` | Lyria 3.5 | stable | DOCUMENTED, LIVE_DISCOVERED, LIVE_VERIFIED | 1,048,576 / 65,536 | None / unknown | 2026-09-03 | - | GET /v1beta/models/lyria-3.5 -> 200 |
| `gemini-3.1-flash-tts-preview` | Gemini 3.1 Flash TTS Preview | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 8,192 / 16,384 | True / unknown | 2026-04-13 | - |  |
| `gemini-robotics-er-2-preview` | Gemini Robotics-ER 2 Preview | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 131,072 / 65,536 | True / unknown | 2026-07-30 | - |  |
| `gemini-2.5-computer-use-preview-10-2025` | Gemini 2.5 Computer Use Preview 10-2025 | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 131,072 / 65,536 | True / unknown | 2025-10-07 | - |  |
| `antigravity-preview-05-2026` | Antigravity Agent Preview | agent | DOCUMENTED, LIVE_DISCOVERED, PREVIEW, DEPRECATED | 1,048,576 / 65,536 | None / unknown | 2026-05-19 | 2026-10-05 |  |
| `antigravity-preview-09-2026` | Antigravity Agent Preview | agent | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 1,048,576 / 65,536 | None / unknown | 2026-09-17 | - |  |
| `deep-research-max-preview-04-2026` | Deep Research Max Preview (Apr-21-2026) | agent | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 131,072 / 65,536 | True / unknown | 2026-04-21 | - |  |
| `deep-research-preview-04-2026` | Deep Research Preview (Apr-21-2026) | agent | DOCUMENTED, LIVE_DISCOVERED, PREVIEW, LIVE_VERIFIED | 131,072 / 65,536 | True / unknown | 2026-04-21 | - | GET /v1beta/models/deep-research-preview-04-2026 -> 200 |
| `deep-research-pro-preview-12-2025` | Deep Research Pro Preview (Dec-12-2025) | agent | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 131,072 / 65,536 | True / unknown | 2025-12-12 | - |  |
| `gemini-embedding-001` | Gemini Embedding 001 | stable | DOCUMENTED, LIVE_DISCOVERED, DEPRECATED | 2,048 / 1 | None / unknown | 2025-07-14 | 2028-05-14 |  |
| `gemini-embedding-2-preview` | Gemini Embedding 2 Preview | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 8,192 / 1 | None / unknown | 2026-03-10 | - |  |
| `gemini-embedding-2` | Gemini Embedding 2 | stable | DOCUMENTED, LIVE_DISCOVERED, LIVE_VERIFIED | 8,192 / 1 | None / unknown | 2026-04-22 | - | GET /v1beta/models/gemini-embedding-2 -> 200 |
| `aqa` | Model that performs Attributed Question Answering. | stable | LIVE_DISCOVERED | 7,168 / 1,024 | None / unknown | ? | - |  |
| `veo-3.1-generate-preview` | Veo 3.1 | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 480 / 8,192 | None / unknown | 2025-10-15 | - |  |
| `veo-3.1-fast-generate-preview` | Veo 3.1 fast | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 480 / 8,192 | None / unknown | 2025-10-15 | - |  |
| `veo-3.1-lite-generate-preview` | Veo 3.1 lite | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW, LIVE_VERIFIED | 480 / 8,192 | None / unknown | 2026-03-31 | - | GET /v1beta/models/veo-3.1-lite-generate-preview -> 200 |
| `gemini-3.5-transcribe-live` | Gemini 3.5 Transcribe Live | stable | DOCUMENTED, LIVE_DISCOVERED | 131,072 / 65,536 | None / unknown | 2026-08 | - |  |
| `gemini-2.5-flash-native-audio-latest` | Gemini 2.5 Flash Native Audio Latest | alias | LIVE_DISCOVERED | 131,072 / 8,192 | True / unknown | ? | - |  |
| `gemini-2.5-flash-native-audio-preview-09-2025` | Gemini 2.5 Flash Native Audio Preview 09-2025 | preview | LIVE_DISCOVERED, PREVIEW | 131,072 / 8,192 | True / unknown | ? | - |  |
| `gemini-2.5-flash-native-audio-preview-12-2025` | Gemini 2.5 Flash Native Audio Preview 12-2025 | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 131,072 / 8,192 | True / unknown | 2025-12-12 | - |  |
| `gemini-3.1-flash-live-preview` | Gemini 3.1 Flash Live Preview | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 131,072 / 65,536 | None / unknown | 2026-03-11 | - |  |
| `gemini-3.8-live` | Gemini 3.8 Live | stable | DOCUMENTED, LIVE_DISCOVERED | 131,072 / 65,536 | None / unknown | 2026-09-15 | - |  |
| `gemini-3.8-live-extended-thinking` | Gemini 3.8 Live Extended Thinking | stable | DOCUMENTED, LIVE_DISCOVERED | 131,072 / 65,536 | True / unknown | 2026-09-15 | - |  |
| `gemini-robotics-er-2-streaming-preview` | Gemini Robotics-ER 2 Streaming Preview | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 131,072 / 65,536 | None / unknown | 2026-07-30 | - |  |
| `gemini-3.5-live-translate-preview` | Gemini 3.5 Live Translate Preview | preview | DOCUMENTED, LIVE_DISCOVERED, PREVIEW | 16,384 / 32,768 | None / unknown | 2026-06 | - |  |
| `lyria-realtime-exp` | Lyria Realtime Experimental | experimental | DOCUMENTED, LIVE_DISCOVERED, BETA | 1,048,576 / 65,536 | None / unknown | 2025-05-20 | - |  |

Shut-down ids still returned by the live listing: `gemini-3-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-image-preview`, `gemini-3-pro-image-preview`/`nano-banana-pro-preview` (deprecations.md dates in the past). Conversely `imagen-4.0-*` (shut down 2026-08-17) is gone: `GET` → 404 `Model is not found … for api version v1beta`.

## 3. Model × Capability matrix (live ids)

Legend: Y = supported (docs and/or live), Y* = supported with qualifier (see JSON, e.g. `Supported (Preview)`), - = not supported, ? = unknown/not documented. Columns: Think=thinking, Struct=structured output (responseSchema/responseJsonSchema), FC=function calling, Search/Maps=grounding, URL=url_context, Code=code execution, CU=computer use, FS=file search, Cache=explicit context caching (live `createCachedContent`), Batch=batchGenerateContent/asyncBatchEmbedContent, Flex/Prio=service tiers, Live=bidiGenerateContent, Inter.=Interactions API, OAI=OpenAI-compatible chat.

| id | Modalities in → out | Think | Struct | FC | Search | Maps | URL | Code | CU | FS | Cache | Batch | Flex | Prio | Live | Inter. | OAI |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| `gemini-2.5-flash` | text+image+audio+video → text | Y | Y | Y | Y | Y | Y | Y | - | Y | Y | Y | Y | Y | - | Y | Y |
| `gemini-2.5-pro` | text+image+audio+video+pdf → text | Y | Y | Y | Y | Y | Y | Y | - | Y | Y | Y | Y | Y | - | Y | Y |
| `gemini-2.5-flash-preview-tts` | text → audio | - | - | - | - | - | - | - | - | - | - | - | - | - | - | ? | Y |
| `gemini-2.5-pro-preview-tts` | text → audio | - | - | - | - | - | - | - | - | - | - | Y | - | - | - | ? | Y |
| `gemma-4-26b-a4b-it` | text → text | Y | ? | ? | ? | ? | ? | ? | ? | ? | - | - | ? | ? | - | ? | Y |
| `gemma-4-31b-it` | text → text | Y | ? | ? | ? | ? | ? | ? | ? | ? | - | - | ? | ? | - | ? | Y |
| `gemini-flash-latest` | text → text | Y | ? | ? | ? | ? | ? | ? | ? | ? | Y | Y | ? | ? | - | ? | Y |
| `gemini-flash-lite-latest` | text → text | Y | ? | ? | ? | ? | ? | ? | ? | ? | Y | Y | ? | ? | - | ? | Y |
| `gemini-pro-latest` | text → text | Y | ? | ? | ? | ? | ? | ? | ? | ? | Y | Y | ? | ? | - | ? | Y |
| `gemini-2.5-flash-lite` | text+image+audio+video+pdf → text | Y | Y | Y | Y | Y | Y | Y | - | Y | Y | Y | Y | Y | - | Y | Y |
| `gemini-2.5-flash-image` | text+image → text+image | - | - | - | - | - | - | - | - | - | - | Y | - | - | - | ? | Y |
| `gemini-3-flash-preview` | text+image+audio+video+pdf → text | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | - | Y | Y |
| `gemini-3.1-pro-preview` | text+image+audio+video+pdf → text | Y | Y | Y | Y | Y | Y | Y | - | Y* | Y | Y | Y | Y | - | Y | Y |
| `gemini-3.1-pro-preview-customtools` | text+image+audio+video+pdf → text | Y | Y | Y | Y | Y | Y | Y | - | Y* | Y | Y | Y | Y | - | ? | Y |
| `gemini-3.1-flash-lite-preview` | text+image+audio+video+pdf → text | Y | Y | Y | Y | Y | Y | Y | - | Y | Y | Y | Y | Y | - | Y | Y |
| `gemini-3.1-flash-lite` | text+image+audio+video+pdf → text | Y | Y | Y | Y | Y | Y | Y | - | Y | Y | Y | Y | Y | - | Y | Y |
| `gemini-3-pro-image-preview` | text+image → text+image | Y | Y | - | Y | - | - | - | - | - | - | Y | Y | Y | - | ? | Y |
| `gemini-3-pro-image` | text+image → text+image | Y | - | - | Y | - | - | - | - | - | - | Y | - | - | - | Y | Y |
| `nano-banana-pro-preview` | text+image → text+image | Y | Y | - | Y | - | - | - | - | - | - | Y | Y | Y | - | ? | Y |
| `gemini-3.1-flash-image-preview` | text+image+pdf → text+image | Y | - | - | Y | - | - | - | - | - | - | Y | ? | ? | - | ? | Y |
| `gemini-3.1-flash-image` | text+image+video+pdf → text+image | Y | - | - | Y | - | - | - | - | - | - | Y | - | - | - | Y | Y |
| `gemini-3.1-flash-lite-image` | text+image+video+pdf → text+image | Y* | - | - | - | - | - | - | - | - | - | Y | - | - | - | Y | Y |
| `gemini-3.5-flash` | text+image+audio+video+pdf → text | Y | Y | Y | Y | Y | Y | Y | Y* | Y | Y | Y | Y | Y | - | Y | Y |
| `gemini-3.5-flash-lite` | text+image+audio+video+pdf → text | Y | Y | Y | Y | Y | Y | Y | Y* | Y | Y | Y | Y | Y | - | Y | Y |
| `gemini-omni-flash-preview` | text+image+video → video | Y | ? | ? | ? | ? | ? | ? | - | ? | - | - | ? | ? | - | Y | - |
| `gemini-omni-1.1-flash` | text+image+video → video | Y | ? | ? | ? | ? | ? | ? | - | ? | - | - | ? | ? | - | Y | - |
| `gemini-3.5-transcribe` | audio → text | - | ? | - | ? | ? | ? | - | - | - | - | - | - | - | - | ? | Y |
| `gemini-3.6-flash` | text+image+audio+video+pdf → text | Y | Y | Y | Y | Y | Y | Y | Y* | Y | Y | Y | Y | Y | - | Y | Y |
| `gemini-3.7-flash` | text+image+audio+video+pdf → text | Y* | Y | Y | Y | Y | Y | Y | Y* | Y | Y | Y | Y | Y | - | Y | Y |
| `gemini-3.8-flash` | text+image+audio+video+pdf → text | Y* | Y | Y | Y | Y | Y | Y | Y* | Y | Y | Y | Y | Y | - | Y | Y |
| `lyria-3-clip-preview` | text+image → audio (music)+text (lyrics) | - | - | - | - | - | - | - | - | - | - | - | - | - | - | Y | - |
| `lyria-3-pro-preview` | text+image → audio (music)+text (lyrics) | - | - | - | - | - | - | - | - | - | - | - | - | - | - | Y | - |
| `lyria-3.5` | text+image → audio (music)+text (lyrics) | - | - | - | - | - | - | - | - | - | - | - | - | - | - | ? | - |
| `gemini-3.1-flash-tts-preview` | text → audio | - | - | - | - | - | - | - | - | - | - | Y | - | - | - | Y | Y |
| `gemini-robotics-er-2-preview` | text+image+audio+video → text | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | - | - | - | ? | Y |
| `gemini-2.5-computer-use-preview-10-2025` | text+image → text | Y | ? | ? | ? | ? | ? | ? | Y | ? | - | - | ? | ? | - | ? | Y |
| `antigravity-preview-05-2026` | text+image → text | - | ? | ? | ? | ? | ? | ? | - | ? | - | - | ? | ? | - | Y | - |
| `antigravity-preview-09-2026` | text → text | - | ? | ? | ? | ? | ? | ? | ? | ? | - | - | ? | ? | - | Y | - |
| `deep-research-max-preview-04-2026` | text+image+audio+video+pdf → text+image | Y | ? | ? | ? | ? | ? | ? | - | ? | - | - | ? | ? | - | Y | - |
| `deep-research-preview-04-2026` | text+image+audio+video+pdf → text+image | Y | ? | ? | ? | ? | ? | ? | - | ? | - | - | ? | ? | - | Y | - |
| `deep-research-pro-preview-12-2025` | text+image+audio+video+pdf → text | Y | ? | ? | ? | ? | ? | ? | - | ? | - | - | ? | ? | - | Y | - |
| `gemini-embedding-001` | text → embedding | - | ? | ? | ? | ? | ? | ? | - | ? | - | Y | ? | ? | - | - | - |
| `gemini-embedding-2-preview` | text+image+audio+video+pdf → embedding | - | ? | ? | ? | ? | ? | ? | - | ? | - | Y | ? | ? | - | - | - |
| `gemini-embedding-2` | text+image+audio+video+pdf → embedding | - | ? | ? | ? | ? | ? | ? | - | ? | - | Y | ? | ? | - | - | - |
| `aqa` | text → text | - | ? | ? | ? | ? | ? | ? | ? | ? | - | - | ? | ? | - | - | - |
| `veo-3.1-generate-preview` | text+image → video (with native audio) | - | ? | ? | ? | ? | ? | ? | - | ? | - | - | ? | ? | - | - | - |
| `veo-3.1-fast-generate-preview` | text+image → video (with native audio) | - | ? | ? | ? | ? | ? | ? | - | ? | - | - | ? | ? | - | - | - |
| `veo-3.1-lite-generate-preview` | text+image → video (with native audio) | - | ? | ? | ? | ? | ? | ? | - | ? | - | - | ? | ? | - | - | - |
| `gemini-3.5-transcribe-live` | audio → text | - | ? | - | ? | ? | ? | - | - | - | - | - | - | - | Y | - | - |
| `gemini-2.5-flash-native-audio-latest` | text → text | Y | ? | ? | ? | ? | ? | ? | ? | ? | - | - | ? | ? | Y | - | - |
| `gemini-2.5-flash-native-audio-preview-09-2025` | text → text | Y | ? | ? | ? | ? | ? | ? | ? | ? | - | - | ? | ? | Y | - | - |
| `gemini-2.5-flash-native-audio-preview-12-2025` | text+audio+video → text+audio | Y | - | Y | Y | - | - | - | - | - | - | - | - | - | Y | - | - |
| `gemini-3.1-flash-live-preview` | text+image+audio+video → text+audio | Y | - | Y | Y | - | - | - | - | - | - | - | ? | ? | Y | - | - |
| `gemini-3.8-live` | text+image+audio+video → text+audio | Y* | - | Y | Y | - | - | - | - | - | - | - | ? | ? | Y | - | - |
| `gemini-3.8-live-extended-thinking` | text+image+audio+video → text+audio | Y | - | Y* | Y | - | - | - | - | - | - | - | ? | ? | Y | - | - |
| `gemini-robotics-er-2-streaming-preview` | text+image+audio+video → text | Y | Y | Y | Y | Y | Y | Y | Y | Y | - | - | - | - | Y | - | - |
| `gemini-3.5-live-translate-preview` | audio → text+audio | - | - | - | - | - | - | - | - | - | - | - | - | - | Y | - | - |
| `lyria-realtime-exp` | text → audio (music, PCM stream) | - | ? | ? | ? | ? | ? | ? | - | ? | - | - | ? | ? | - | - | - |

Thinking levels (thinking.md): `gemini-3.8-flash` default **medium**, levels low/medium/high; `gemini-3.7-flash` default **medium**, levels low/medium/high; `gemini-3.6-flash` default **medium**, levels minimal/low/medium/high; `gemini-3.5-flash-lite` default **minimal**, levels minimal/low/medium/high; `gemini-3.1-pro-preview` default **high**, levels low/medium/high; `gemini-3.1-pro-preview-customtools` default **high**, levels low/medium/high; `gemini-3.1-flash-lite-image` default **minimal**, levels minimal/high; `gemini-3-flash-preview` default **high**, levels minimal/low/medium/high; `gemini-3-pro-preview` default **high**, levels low/high; `gemini-3.5-flash` default **medium**, levels minimal/low/medium/high; `gemini-3.1-flash-lite` default **unknown (docs table omits it; openai.md maps minimal/low/medium/high)**, levels minimal/low/medium/high. Gemini 2.5: `thinking_budget` (2.5 Flash-Lite off by default; 2.5 Pro cannot be disabled). Gemini 3.x: `thinking_level` replaces `thinking_budget` (400 if both are sent); `minimal` is rejected by 3.7/3.8 Flash; thought signatures must be echoed in multi-turn function calling (`MISSING_THOUGHT_SIGNATURE`).

## 4. Model × Endpoint matrix (`supportedGenerationMethods`, verbatim from live)

`streamGenerateContent` is never listed but is implied by `generateContent`. `interactions` (POST /v1beta/interactions) is not reported by the Models API; see column Inter. above.

| id | generateContent | countTokens | createCachedContent | batchGenerateContent | embedContent | asyncBatchEmbedContent | countTextTokens | predictLongRunning | bidiGenerateContent | bidiGenerateMusic | generateAnswer |
|---|---|---|---|---|---|---|---|---|---|---|---|
| `gemini-2.5-flash` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-2.5-pro` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-2.5-flash-preview-tts` | Y | Y | - | - | - | - | - | - | - | - | - |
| `gemini-2.5-pro-preview-tts` | Y | Y | - | Y | - | - | - | - | - | - | - |
| `gemma-4-26b-a4b-it` | Y | Y | - | - | - | - | - | - | - | - | - |
| `gemma-4-31b-it` | Y | Y | - | - | - | - | - | - | - | - | - |
| `gemini-flash-latest` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-flash-lite-latest` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-pro-latest` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-2.5-flash-lite` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-2.5-flash-image` | Y | Y | - | Y | - | - | - | - | - | - | - |
| `gemini-3-flash-preview` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-3.1-pro-preview` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-3.1-pro-preview-customtools` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-3.1-flash-lite-preview` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-3.1-flash-lite` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-3-pro-image-preview` | Y | Y | - | Y | - | - | - | - | - | - | - |
| `gemini-3-pro-image` | Y | Y | - | Y | - | - | - | - | - | - | - |
| `nano-banana-pro-preview` | Y | Y | - | Y | - | - | - | - | - | - | - |
| `gemini-3.1-flash-image-preview` | Y | Y | - | Y | - | - | - | - | - | - | - |
| `gemini-3.1-flash-image` | Y | Y | - | Y | - | - | - | - | - | - | - |
| `gemini-3.1-flash-lite-image` | Y | Y | - | Y | - | - | - | - | - | - | - |
| `gemini-3.5-flash` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-3.5-flash-lite` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-omni-flash-preview` | Y | Y | - | - | - | - | - | - | - | - | - |
| `gemini-omni-1.1-flash` | Y | Y | - | - | - | - | - | - | - | - | - |
| `gemini-3.5-transcribe` | Y | Y | - | - | - | - | - | - | - | - | - |
| `gemini-3.6-flash` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-3.7-flash` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-3.8-flash` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `lyria-3-clip-preview` | Y | Y | - | - | - | - | - | - | - | - | - |
| `lyria-3-pro-preview` | Y | Y | - | - | - | - | - | - | - | - | - |
| `lyria-3.5` | Y | Y | - | - | - | - | - | - | - | - | - |
| `gemini-3.1-flash-tts-preview` | Y | Y | - | Y | - | - | - | - | - | - | - |
| `gemini-robotics-er-2-preview` | Y | Y | Y | Y | - | - | - | - | - | - | - |
| `gemini-2.5-computer-use-preview-10-2025` | Y | Y | - | - | - | - | - | - | - | - | - |
| `antigravity-preview-05-2026` | Y | Y | - | - | - | - | - | - | - | - | - |
| `antigravity-preview-09-2026` | Y | Y | - | - | - | - | - | - | - | - | - |
| `deep-research-max-preview-04-2026` | Y | Y | - | - | - | - | - | - | - | - | - |
| `deep-research-preview-04-2026` | Y | Y | - | - | - | - | - | - | - | - | - |
| `deep-research-pro-preview-12-2025` | Y | Y | - | - | - | - | - | - | - | - | - |
| `gemini-embedding-001` | - | Y | - | - | Y | Y | Y | - | - | - | - |
| `gemini-embedding-2-preview` | - | Y | - | - | Y | Y | Y | - | - | - | - |
| `gemini-embedding-2` | - | Y | - | - | Y | Y | Y | - | - | - | - |
| `aqa` | - | - | - | - | - | - | - | - | - | - | Y |
| `veo-3.1-generate-preview` | - | - | - | - | - | - | - | Y | - | - | - |
| `veo-3.1-fast-generate-preview` | - | - | - | - | - | - | - | Y | - | - | - |
| `veo-3.1-lite-generate-preview` | - | - | - | - | - | - | - | Y | - | - | - |
| `gemini-3.5-transcribe-live` | - | - | - | - | - | - | - | - | Y | - | - |
| `gemini-2.5-flash-native-audio-latest` | - | Y | - | - | - | - | - | - | Y | - | - |
| `gemini-2.5-flash-native-audio-preview-09-2025` | - | Y | - | - | - | - | - | - | Y | - | - |
| `gemini-2.5-flash-native-audio-preview-12-2025` | - | Y | - | - | - | - | - | - | Y | - | - |
| `gemini-3.1-flash-live-preview` | - | - | - | - | - | - | - | - | Y | - | - |
| `gemini-3.8-live` | - | - | - | - | - | - | - | - | Y | - | - |
| `gemini-3.8-live-extended-thinking` | - | - | - | - | - | - | - | - | Y | - | - |
| `gemini-robotics-er-2-streaming-preview` | - | - | - | - | - | - | - | - | Y | - | - |
| `gemini-3.5-live-translate-preview` | - | - | - | - | - | - | - | - | Y | - | - |
| `lyria-realtime-exp` | - | - | - | - | - | - | - | - | - | Y | - |

## 5. Model × Tool matrix (built-in tools; docs support tables)

| id | google_search | google_maps | url_context | code_execution | computer_use | file_search | function_declarations |
|---|---|---|---|---|---|---|---|
| `gemini-2.5-flash` | Y | Y | Y | Y | - | Y | Y |
| `gemini-2.5-pro` | Y | Y | Y | Y | - | Y | Y |
| `gemini-2.5-flash-lite` | Y | Y | Y | Y | - | Y | Y |
| `gemini-3-flash-preview` | Y | Y | Y | Y | Y | Y | Y |
| `gemini-3.1-pro-preview` | Y | Y | Y | Y | - | Y* | Y |
| `gemini-3.1-pro-preview-customtools` | Y | Y | Y | Y | - | Y* | Y |
| `gemini-3.1-flash-lite-preview` | Y | Y | Y | Y | - | Y | Y |
| `gemini-3.1-flash-lite` | Y | Y | Y | Y | - | Y | Y |
| `gemini-3-pro-image-preview` | Y | - | - | - | - | - | - |
| `gemini-3-pro-image` | Y | - | - | - | - | - | - |
| `nano-banana-pro-preview` | Y | - | - | - | - | - | - |
| `gemini-3.1-flash-image-preview` | Y | - | - | - | - | - | - |
| `gemini-3.1-flash-image` | Y | - | - | - | - | - | - |
| `gemini-3.5-flash` | Y | Y | Y | Y | Y* | Y | Y |
| `gemini-3.5-flash-lite` | Y | Y | Y | Y | Y* | Y | Y |
| `gemini-3.6-flash` | Y | Y | Y | Y | Y* | Y | Y |
| `gemini-3.7-flash` | Y | Y | Y | Y | Y* | Y | Y |
| `gemini-3.8-flash` | Y | Y | Y | Y | Y* | Y | Y |
| `gemini-robotics-er-2-preview` | Y | Y | Y | Y | Y | Y | Y |
| `gemini-2.5-computer-use-preview-10-2025` | - | - | - | - | Y | - | - |
| `gemini-2.5-flash-native-audio-preview-12-2025` | Y | - | - | - | - | - | Y |
| `gemini-3.1-flash-live-preview` | Y | - | - | - | - | - | Y |
| `gemini-3.8-live` | Y | - | - | - | - | - | Y |
| `gemini-3.8-live-extended-thinking` | Y | - | - | - | - | - | Y* |
| `gemini-robotics-er-2-streaming-preview` | Y | Y | Y | Y | Y | Y | Y |

Tool pricing: Google Search $14/1k requests after 5,000 free/month (Gemini 3; $35/1k grounded prompts after 1,500 RPD on 2.5); Maps $14/1k queries (Gemini 3) or $25/1k prompts (2.5); code execution / URL context / computer use billed as tokens; File Search indexing $0.15/1M tokens. Built-in tools can be combined with function calling since 2026-03-18 (tool-combination.md).

## 6. Live vs docs discrepancies

| id | Discrepancy |
|---|---|
| `gemini-2.5-flash-preview-tts` | docs: Batch API supported, but batchGenerateContent absent from live supportedGenerationMethods |
| `gemma-4-26b-a4b-it` | Gemma 4 not documented in models.md (only pricing.md + changelog); live thinking=true and probe returned thoughtsTokenCount=5 |
| `gemma-4-31b-it` | Gemma 4 not documented in models.md (only pricing.md + changelog); live thinking=true and probe returned thoughtsTokenCount=5 |
| `gemini-flash-latest` | live version field holds the display name ('Gemini Flash Latest') instead of a version |
| `gemini-flash-lite-latest` | live version field holds the display name ('Gemini Flash-Lite Latest') instead of a version |
| `gemini-pro-latest` | live version field holds the display name ('Gemini Pro Latest') instead of a version |
| `gemini-2.5-flash-image` | inputTokenLimit live=32768 vs docs=65536 |
| `gemini-2.5-flash-image` | docs: input limit 65,536 vs live 32,768; live description still says 'Gemini 2.5 Flash Preview Image' |
| `gemini-3.1-pro-preview-customtools` | live-listed id without a dedicated docs model page |
| `gemini-3-pro-image-preview` | inputTokenLimit live=131072 vs docs=65536 |
| `gemini-3-pro-image` | inputTokenLimit live=131072 vs docs=65536 |
| `nano-banana-pro-preview` | inputTokenLimit live=131072 vs docs=65536 |
| `nano-banana-pro-preview` | live-listed id without a dedicated docs model page |
| `gemini-3.1-flash-image-preview` | inputTokenLimit live=65536 vs docs=131072 |
| `gemini-3.1-flash-image-preview` | outputTokenLimit live=65536 vs docs=32768 |
| `gemini-3.1-flash-image` | inputTokenLimit live=65536 vs docs=131072 |
| `gemini-3.1-flash-image` | outputTokenLimit live=65536 vs docs=32768 |
| `gemini-3.1-flash-lite-image` | outputTokenLimit live=65536 vs docs=4096 |
| `gemini-3.5-transcribe` | thinking: docs 'Not supported' vs live thinking=True |
| `gemini-3.5-transcribe` | docs: Thinking not supported vs live thinking=true |
| `gemini-3.8-flash` | live version field is '3.0' (other 3.x GA models carry dated versions like 3.7-flash-08-2026) |
| `lyria-3-clip-preview` | inputTokenLimit live=1048576 vs docs=131072 |
| `lyria-3-pro-preview` | inputTokenLimit live=1048576 vs docs=131072 |
| `lyria-3.5` | inputTokenLimit live=1048576 vs docs=131072 |
| `gemini-3.1-flash-tts-preview` | thinking: docs 'Not supported' vs live thinking=True |
| `gemini-2.5-computer-use-preview-10-2025` | inputTokenLimit live=131072 vs docs=128000 |
| `gemini-2.5-computer-use-preview-10-2025` | outputTokenLimit live=65536 vs docs=64000 |
| `antigravity-preview-09-2026` | live-listed id without a dedicated docs model page |
| `deep-research-max-preview-04-2026` | inputTokenLimit live=131072 vs docs=1048576 |
| `deep-research-max-preview-04-2026` | live version 'deepthink-exp-05-20' and inputTokenLimit 131,072 vs docs 'Input context window 1,048,576' |
| `deep-research-preview-04-2026` | inputTokenLimit live=131072 vs docs=1048576 |
| `deep-research-preview-04-2026` | live version 'deepthink-exp-05-20' and inputTokenLimit 131,072 vs docs 'Input context window 1,048,576' |
| `deep-research-pro-preview-12-2025` | inputTokenLimit live=131072 vs docs=1048576 |
| `deep-research-pro-preview-12-2025` | live version 'deepthink-exp-05-20' and inputTokenLimit 131,072 vs docs 'Input context window 1,048,576' |
| `aqa` | live-listed id without a dedicated docs model page (aqa: legacy generateAnswer-only model, undocumented) |
| `gemini-2.5-flash-native-audio-latest` | live version field holds the display name ('Gemini 2.5 Flash Native Audio Latest') instead of a version |
| `gemini-2.5-flash-native-audio-latest` | live-listed id without a dedicated docs model page |
| `gemini-2.5-flash-native-audio-preview-09-2025` | live-listed id without a dedicated docs model page |
| `gemini-3.1-flash-live-preview` | thinking: docs 'Supported' vs live thinking=None |
| `gemini-3.8-live` | thinking: docs 'Supported (interleaved reasoning)' vs live thinking=None |
| `gemini-3.8-live` | live version field is '3.1-flash-live-03-2026' (same as gemini-3.1-flash-live-preview) |
| `gemini-3.8-live` | docs: 'Thinking Supported (interleaved reasoning)' vs live thinking flag absent |
| `gemini-3.8-live-extended-thinking` | live version field is '3.1-flash-live-03-2026' (same as gemini-3.1-flash-live-preview) |
| `gemini-robotics-er-2-streaming-preview` | thinking: docs 'Supported' vs live thinking=None |
| `gemini-robotics-er-2-streaming-preview` | docs: Batch API supported, but batchGenerateContent absent from live supportedGenerationMethods |
| `gemini-robotics-er-2-streaming-preview` | docs: Caching supported, but createCachedContent absent from live supportedGenerationMethods |
| `gemini-3.5-live-translate-preview` | inputTokenLimit live=16384 vs docs=131072 |
| `gemini-3.5-live-translate-preview` | outputTokenLimit live=32768 vs docs=65536 |

Global: api-versions.md says all models exist in both `v1` and `v1beta`, but `GET /v1/models` lists only 22 GA ids and `GET /v1/models/gemini-3.1-pro-preview` → 404. The Gemini 2.5 family returns 404 `no longer available to new users` on generation for new keys (undocumented). Our key is Free tier: Pro models answer 429 `limit: 0`.

## 7. Documented-only / retired ids (not in the live listing)

| id | Family | Status | Released | Shutdown | Replacement |
|---|---|---|---|---|---|
| `gemini-2.0-flash` | Gemini 2.0 | DOCUMENTED, RETIRED | 2025-02-05 | 2026-06-01 | gemini-3.6-flash |
| `gemini-2.0-flash-001` | Gemini 2.0 | DOCUMENTED, RETIRED | 2025-02-05 | 2026-06-01 | gemini-3.6-flash |
| `gemini-2.0-flash-lite` | Gemini 2.0 | DOCUMENTED, RETIRED | 2025-02-25 | 2026-06-01 | gemini-3.1-flash-lite |
| `gemini-2.0-flash-lite-001` | Gemini 2.0 | DOCUMENTED, RETIRED | 2025-02-25 | 2026-06-01 | gemini-3.1-flash-lite |
| `gemini-2.0-flash-exp` | Gemini 2.0 | DOCUMENTED, BETA, UNVERIFIED | ? | - | - |
| `gemini-2.0-flash-preview-image-generation` | Gemini 2.0 | DOCUMENTED, PREVIEW, RETIRED | 2025-05-07 | 2025-11-14 | gemini-2.5-flash-image |
| `gemini-2.0-flash-lite-preview` | Gemini 2.0 | DOCUMENTED, PREVIEW, RETIRED | 2025-02-05 | 2025-12-09 | gemini-2.5-flash-lite |
| `gemini-2.0-flash-lite-preview-02-05` | Gemini 2.0 | DOCUMENTED, PREVIEW, RETIRED | 2025-02-05 | 2025-12-09 | gemini-2.5-flash-lite |
| `gemini-2.0-flash-live-001` | Gemini 2.0 | DOCUMENTED, RETIRED | 2025-04-09 | 2025-12-09 | gemini-3.8-live |
| `gemini-2.5-pro-preview-03-25` | Gemini 2.5 | DOCUMENTED, PREVIEW, RETIRED | 2025-03-03 | 2025-12-02 | gemini-3.1-pro-preview |
| `gemini-2.5-pro-preview-05-06` | Gemini 2.5 | DOCUMENTED, PREVIEW, RETIRED | 2025-05-06 | 2025-12-02 | gemini-3.1-pro-preview |
| `gemini-2.5-pro-preview-06-05` | Gemini 2.5 | DOCUMENTED, PREVIEW, RETIRED | 2025-06-05 | 2025-12-02 | gemini-3.1-pro-preview |
| `gemini-2.5-flash-preview-05-20` | Gemini 2.5 | DOCUMENTED, PREVIEW, RETIRED | 2025-05-20 | 2025-11-18 | gemini-3.6-flash |
| `gemini-2.5-flash-preview-09-2025` | Gemini 2.5 | DOCUMENTED, PREVIEW, UNVERIFIED | ? | - | - |
| `gemini-2.5-flash-preview-09-25` | Gemini 2.5 | DOCUMENTED, PREVIEW, RETIRED | 2025-09-25 | 2026-02-17 | gemini-3.6-flash |
| `gemini-2.5-flash-lite-preview-09-2025` | Gemini 2.5 | DOCUMENTED, PREVIEW, RETIRED | 2025-09-25 | 2026-03-31 | gemini-3.1-flash-lite |
| `gemini-2.5-flash-image-preview` | Gemini 2.5 | DOCUMENTED, PREVIEW, RETIRED | 2025-05-07 | 2026-01-15 | gemini-2.5-flash-image |
| `gemini-live-2.5-flash-preview` | Gemini | DOCUMENTED, PREVIEW, RETIRED | 2025-06-17 | 2025-12-09 | gemini-3.8-live |
| `text-embedding-004` | Gemini Embedding | DOCUMENTED, RETIRED | 2024-04-09 | 2026-01-14 | gemini-embedding-2 |
| `embedding-001` | Gemini Embedding | DOCUMENTED, RETIRED | 2024-04-09 | 2025-10-30 | gemini-embedding-2 |
| `embedding-gecko-001` | Gemini Embedding | DOCUMENTED, RETIRED | ? | 2025-10-30 | gemini-embedding-2 |
| `gemini-embedding-exp` | Gemini Embedding | DOCUMENTED, BETA, RETIRED | ? | 2025-10-30 | gemini-embedding-2 |
| `gemini-embedding-exp-03-07` | Gemini Embedding | DOCUMENTED, BETA, RETIRED | ? | 2025-10-30 | gemini-embedding-2 |
| `embedding-2-preview` | Gemini Embedding | DOCUMENTED, PREVIEW, RETIRED | 2026-03-10 | 2026-08-10 | gemini-embedding-2 |
| `imagen-4.0-generate-001` | Imagen | DOCUMENTED, RETIRED | 2025-06-24 | 2026-08-17 | gemini-3.1-flash-image |
| `imagen-4.0-ultra-generate-001` | Imagen | DOCUMENTED, RETIRED | 2025-06-24 | 2026-08-17 | gemini-3.1-flash-image |
| `imagen-4.0-fast-generate-001` | Imagen | DOCUMENTED, RETIRED | 2025-06-24 | 2026-08-17 | gemini-3.1-flash-image |
| `imagen-3.0-generate-002` | Imagen | DOCUMENTED, RETIRED | 2025-02-06 | 2025-11-10 | imagen-4.0-generate-001 |
| `imagen-4.0-generate-preview-06-06` | Imagen | DOCUMENTED, PREVIEW, RETIRED | 2025-06-24 | 2026-02-17 | imagen-4.0-generate-001 |
| `imagen-4.0-ultra-generate-preview-06-06` | Imagen | DOCUMENTED, PREVIEW, RETIRED | 2025-06-24 | 2026-02-17 | imagen-4.0-ultra-generate-001 |
| `veo-2.0-generate-001` | Veo | DOCUMENTED, RETIRED | 2025-04-09 | 2026-06-30 | veo-3.1-generate-preview |
| `veo-3.0-generate-001` | Veo | DOCUMENTED, RETIRED | 2025-09-09 | 2026-06-30 | veo-3.1-generate-preview |
| `veo-3.0-fast-generate-001` | Veo | DOCUMENTED, RETIRED | 2025-09-09 | 2026-06-30 | veo-3.1-fast-generate-preview |
| `veo-3.0-generate-preview` | Veo | DOCUMENTED, PREVIEW, RETIRED | 2025-07-31 | 2025-11-12 | veo-3.1-generate-preview |
| `veo-3.0-fast-generate-preview` | Veo | DOCUMENTED, PREVIEW, RETIRED | 2025-07-31 | 2025-11-12 | veo-3.1-fast-generate-preview |
| `gemini-robotics-er-1.5-preview` | Gemini Robotics-ER | DOCUMENTED, PREVIEW, RETIRED | 2025-09-25 | 2026-04-30 | gemini-robotics-er-1.6-preview |
| `gemini-robotics-er-1.6-preview` | Gemini Robotics-ER | DOCUMENTED, PREVIEW, RETIRED | 2026-04-14 | 2026-08-31 | gemini-robotics-er-2-preview |
| `lyria-3.5-clip-preview` | Lyria | DOCUMENTED, PREVIEW, UNVERIFIED | ? | - | - |
| `lyria-3.5-pro-preview` | Lyria | DOCUMENTED, PREVIEW, UNVERIFIED | ? | - | - |

## 8. Preview / availability policy

- Preview models: production use allowed, billing enabled, more restrictive rate limits, ≥2 weeks deprecation notice; `-latest` aliases: 2-week e-mail notice before a breaking swap.
- Free tier: many text models are free of charge (content used to improve Google products — Unpaid Services terms); Pro, image, video, music, Omni and Deep Research/Antigravity agents need a paid key (observed `limit: 0` on Pro).
- Regions: ~190 countries/territories (available-regions.md). EEA/UK/CH: free and paid tiers available to developers, but API clients serving end users there must use Paid Services (terms §Use Restrictions).
- Gemini Enterprise Agent Platform (Vertex AI) offers most Gemini/Veo ids with regional endpoints and enterprise controls — see [vertex-vs-gemini-api](../gemini/vertex-vs-gemini-api.md).

## 9. Live probe summary (2026-09-19)

| Call | Result |
|---|---|
| `POST models/gemma-4-26b-a4b-it:generateContent` (maxOutputTokens 8) | HTTP 200; modelVersion `gemma-4-26b-a4b-it`, finishReason MAX_TOKENS, usage {"promptTokenCount": 5, "totalTokenCount": 10, "promptTokensDetails": [{"modality": "TEXT", "tokenCount": 5}], "thoughtsTokenCount": 5, "serviceTier": "standard"}, thoughtSignature=False |
| `POST models/gemini-flash-latest:generateContent` (maxOutputTokens 8) | HTTP 200; modelVersion `gemini-3.8-flash`, finishReason MAX_TOKENS, usage {"promptTokenCount": 5, "totalTokenCount": 10, "promptTokensDetails": [{"modality": "TEXT", "tokenCount": 5}], "thoughtsTokenCount": 5, "serviceTier": "standard"}, thoughtSignature=False |
| `POST models/gemini-pro-latest:generateContent` (maxOutputTokens 8) | HTTP 429; {"error": {"code": 429, "message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, head to: https://ai.google.dev/gemini-api/docs/rate-limits. To monitor  |
| `POST models/gemini-2.5-flash-lite:generateContent` (maxOutputTokens 8) | HTTP 404; {"error": {"code": 404, "message": "This model models/gemini-2.5-flash-lite is no longer available to new users. Please update your code to use models/gemini-3.5-flash-lite for the latest features and improvements. We re |
| `POST models/gemini-3.1-pro-preview:generateContent` (maxOutputTokens 8) | HTTP 429; {"error": {"code": 429, "message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, head to: https://ai.google.dev/gemini-api/docs/rate-limits. To monitor  |
| `POST models/gemini-3.5-flash:generateContent` (maxOutputTokens 8) | HTTP 200; modelVersion `gemini-3.5-flash`, finishReason MAX_TOKENS, usage {"promptTokenCount": 5, "totalTokenCount": 10, "promptTokensDetails": [{"modality": "TEXT", "tokenCount": 5}], "thoughtsTokenCount": 5, "serviceTier": "standard"}, thoughtSignature=False |
| `POST models/gemini-3.5-flash-lite:generateContent` (maxOutputTokens 8) | HTTP 200; modelVersion `gemini-3.5-flash-lite`, finishReason STOP, usage {"promptTokenCount": 5, "candidatesTokenCount": 2, "totalTokenCount": 7, "promptTokensDetails": [{"modality": "TEXT", "tokenCount": 5}], "serviceTier": "standard"}, thoughtSignature=True |
| `POST models/gemini-3.8-flash:generateContent` (maxOutputTokens 8) | HTTP 200; modelVersion `gemini-3.8-flash`, finishReason MAX_TOKENS, usage {"promptTokenCount": 5, "totalTokenCount": 10, "promptTokensDetails": [{"modality": "TEXT", "tokenCount": 5}], "thoughtsTokenCount": 5, "serviceTier": "standard"}, thoughtSignature=False |
| `POST /v1beta/openai/chat/completions` gemini-3.5-flash-lite | 200 with `Authorization: Bearer`; 400 INVALID_ARGUMENT with only `x-goog-api-key` |
| `GET /v1beta/openai/models` | 200, 58 ids prefixed `models/` |
| `GET /v1/models` | 200, 22 ids (3 pages at pageSize=10) |

Estimated cost of all probes: < $0.001 (a few hundred tokens on Free-tier models).