---
title: Gemini API Models Reference
tags:
  - ai
  - gemini
  - google
  - api
aliases:
  - Gemini Models
  - Google AI Models
date: 2026-05-08
source: https://ai.google.dev/gemini-api/docs/models
---

# Gemini API Models Reference

API-идентификаторы извлечены из URL-ов официальной документации. Используй точные ID при настройке моделей.

> [!tip] Как читать эту таблицу
> Колонка **API ID** — это строка, которую передаёшь в `model=` при вызове API. Именно она, а не маркетинговое название.

---

## Gemini 3

| Маркетинговое название | API ID | Статус | Назначение |
|------------------------|--------|--------|-----------|
| Gemini 3.1 Pro | `gemini-3.1-pro-preview` | Preview | Сложные задачи, агентика, coding |
| Gemini 3 Flash | `gemini-3-flash-preview` | Preview | Баланс цена/качество, замена 2.5 Flash |
| Gemini 3.1 Flash-Lite | `gemini-3.1-flash-lite` | **Stable** | Быстрый, дешёвый |
| Gemini 3.1 Flash-Lite | `gemini-3.1-flash-lite-preview` | Preview | То же, но preview-версия |
| Gemini 3.1 Flash Live | `gemini-3.1-flash-live-preview` | New Preview | Real-time диалог, voice-first |
| Gemini 3.1 Flash TTS | `gemini-3.1-flash-tts-preview` | New Preview | TTS, низкая латентность |
| Nano Banana 2 (image gen) | `gemini-3.1-flash-image-preview` | Preview | Генерация изображений, высокий throughput |
| Nano Banana Pro (image gen) | `gemini-3-pro-image-preview` | Preview | Studio-quality изображения, контекстная генерация |

> [!warning] Нет `gemini-3.1-flash-preview`
> Такого ID **не существует**. Путаница возникает из-за того, что есть `gemini-3-flash-preview` (без `.1`) и `gemini-3.1-flash-lite-preview` (с `-lite`). При 404 — проверь ID по этой таблице.

---

## Gemini 2.5

| Маркетинговое название | API ID | Статус | Назначение |
|------------------------|--------|--------|-----------|
| Gemini 2.5 Pro | `gemini-2.5-pro` | Stable | Флагман, сложные задачи, reasoning |
| Gemini 2.5 Pro TTS | `gemini-2.5-pro-preview-tts` | Preview | Высококачественный TTS (podcast, audiobook) |
| Gemini 2.5 Flash | `gemini-2.5-flash` | Stable | Основная рабочая лошадь, reasoning |
| Gemini 2.5 Flash TTS | `gemini-2.5-flash-preview-tts` | Preview | Контролируемый TTS, низкая латентность |
| Gemini 2.5 Flash Live | `gemini-2.5-flash-live-preview` | Preview | Live API, двунаправленный аудио/видео |
| Gemini 2.5 Flash-Lite | `gemini-2.5-flash-lite` | Stable | Самый быстрый и дешёвый в серии 2.5 |
| Nano Banana (image gen) | `gemini-2.5-flash-image-preview` | Preview | Нативная генерация изображений |

---

## Устаревшие модели

| API ID | Статус |
|--------|--------|
| `gemini-2.0-flash` | Deprecated |
| `gemini-2.0-flash-lite` | Deprecated |
| `gemini-3-pro-preview` | Shutdown |

---

## Версионирование

| Тип | Паттерн | Пример | Поведение |
|-----|---------|--------|-----------|
| Stable | `gemini-X.Y-name` | `gemini-2.5-flash` | Не меняется |
| Preview | `gemini-X.Y-name-preview` | `gemini-3.1-pro-preview` | Billing включён, min 2 недели notice перед deprecation |
| Latest | `gemini-name-latest` | `gemini-flash-latest` | Hot-switch на новую версию |
| Experimental | `gemini-name-exp-MMDD` | — | Нестабильный, для feedback |

---

## Паттерн fallback-цепочки (video-accessibility)

```python
# gemini.py — текущая конфигурация
class GeminiService:
    _fallback_models = [
        "gemini-3.1-flash-preview",  # ⚠️ проверить: возможно нужен gemini-3-flash-preview
        "gemini-2.5-pro",
    ]
    model_name = "gemini-3.1-pro-preview"  # primary
```

Fallback срабатывает **только на 429 / RESOURCE_EXHAUSTED**. Ошибка 404 (неверный ID) — прерывает цепочку немедленно.

---

## Связанные заметки

- [[cost-tracker-pricing-sources]] — стоимость моделей по токенам
- [[python-ai-agents]] — агентные паттерны с Gemini
