96 lines
4.6 KiB
Markdown
96 lines
4.6 KiB
Markdown
---
|
||
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
|