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)
# 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) — прерывает цепочку немедленно.
Связанные заметки
