# Gemini 3.8 Flash API: ID модели, цены, лимиты и миграция

> Gemini 3.8 Flash стала общедоступной 2 сентября 2026 года. Точный ID, лимиты, инструменты, тарифы, первый запрос и переход с 3.7, запросы к которой с 8 октября автоматически идут на 3.8.

- Source: https://www.aifreeapi.com/ru/posts/gemini-3-8-flash
- Language: ru
- Published: 2026-09-02
- Updated: 2026-10-10
- Publisher: AI Free API (https://www.aifreeapi.com)

Google объявил общедоступный выпуск **Gemini 3.8 Flash** 2 сентября 2026 года. [Журнал изменений Gemini API](https://ai.google.dev/gemini-api/docs/changelog). Точный ID в Gemini Developer API — `gemini-3.8-flash`. Google называет её своей самой интеллектуальной Flash-моделью для длительной разработки ПО, автономных агентов и сложных корпоративных процессов.

8 октября 2026 года Google объявила `gemini-3.7-flash` устаревшей: все запросы к ней автоматически выполняет `gemini-3.8-flash` ([журнал изменений](https://ai.google.dev/gemini-api/docs/changelog)). Если ваш код ещё обращается к 3.7, он уже работает на 3.8 — замените строку модели и сверьте метрики на своих задачах. До конца 2026 года Standard стоит $0,75 за миллион входных и $3,75 за миллион выходных токенов, а с 1 января 2027 года тариф удваивается.

## Официальные характеристики

По [странице модели](https://ai.google.dev/gemini-api/docs/models/gemini-3.8-flash):

| Свойство | Значение |
| --- | --- |
| ID | `gemini-3.8-flash` |
| Статус | Stable / GA |
| Вход | текст, изображения, видео, аудио, PDF |
| Выход | текст |
| Лимит входа | 1 048 576 токенов |
| Лимит выхода | 65 536 токенов |
| Thinking | `low`, `medium`, `high` |
| Режимы | Standard, Batch, Flex, Priority |

Мультимодальный вход не означает генерацию медиа. 3.8 Flash не генерирует изображения или аудио и не поддерживает Live API.

## Инструменты и ограничения

Модель поддерживает кэширование контекста, выполнение кода, поиск по файлам, вызов функций и структурированный вывод. Ответы можно дополнять данными Google Search, Google Maps и страниц по URL. Управление компьютером доступно в предварительной версии.

Учтите три ограничения:

- уровень рассуждений `minimal` возвращает ошибку; доступны только `low`, `medium`, `high`;
- генерация изображений и аудио не поддерживаются;
- Live API не поддерживается.

Для поиска с опорой на внешние источники, хранения кэша, управления компьютером и разных режимов обработки действуют отдельные условия. Наличие функции в списке возможностей не означает, что её стоимость входит в цену токенов.

## Цены Gemini 3.8 Flash

[Официальные цены](https://ai.google.dev/gemini-api/docs/pricing) указаны в долларах за 1 млн токенов. В цену вывода входят токены рассуждений.

| Режим | Вход до 31.12.2026 | Выход до 31.12.2026 | Вход с 01.01.2027 | Выход с 01.01.2027 |
| --- | ---: | ---: | ---: | ---: |
| Standard | $0.75 | $3.75 | $1.50 | $7.50 |
| Batch | $0.375 | $1.875 | $0.75 | $3.75 |
| Flex | $0.375 | $1.875 | $0.75 | $3.75 |
| Priority | $1.35 | $6.75 | $2.70 | $13.50 |

В таблицах Standard и Priority указан бесплатный уровень; у Batch и Flex его нет. Кэширование и поиск имеют отдельные тарифы. Для сравнения моделей считайте среднюю стоимость успешно выполненной задачи:

`средняя стоимость = все расходы серии, включая оплаченные повторы / число задач, прошедших проверку`

В расходы включайте вход с учётом кэша, выход вместе с рассуждениями, хранение кэша и отдельно оплачиваемые инструменты. Не прибавляйте токены рассуждений повторно к выводу, который уже их включает. Если успешных задач нет, средняя стоимость результата не определена.

![Русская схема безопасного перехода на Gemini 3.8 Flash с пробным запуском на небольшой доле запросов и сравнительными показателями, стоимостью принятой задачи и учётом тарифов 2027 года](https://www.aifreeapi.com/posts/ru/gemini-3-8-flash/img/migration-and-cost-control.webp)

## Первый запрос

Текущее [руководство по генерации текста](https://ai.google.dev/gemini-api/docs/text-generation) использует Interactions API:

```python
from google import genai

client = genai.Client()
interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Оцените план развёртывания: заменить модель сразу для всех запросов, не проводя сравнительных тестов и не сохраняя старую конфигурацию. Назовите три риска.",
)
print(interaction.output_text)
```

REST-вариант:

```bash
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.8-flash","input":"Оцените план развёртывания: заменить модель сразу для всех запросов, не проводя сравнительных тестов и не сохраняя старую конфигурацию. Назовите три риска."}'
```

Для запуска установите пакет `google-genai`, задайте свой ключ в `GEMINI_API_KEY` и проверьте доступ проекта к модели. Примеры основаны на документации; платные запросы для статьи не выполнялись. Для сопоставимого сравнения задавайте одинаковый `thinking_level`, инструменты и время ожидания. В ответах с вызовами инструментов или несколькими типами блоков обрабатывайте полную структуру, а не только свойство SDK `output_text`.

## Переход с Gemini 3.7 Flash

Выбирать между 3.7 и 3.8 больше не нужно: 8 октября 2026 года Google объявила `gemini-3.7-flash` устаревшей, и все запросы к этому ID автоматически перенаправляются на `gemini-3.8-flash`. Google просит обновить строку модели ([журнал изменений](https://ai.google.dev/gemini-api/docs/changelog)). В [графике вывода моделей из эксплуатации](https://ai.google.dev/gemini-api/docs/deprecations) для 3.7 Flash дата отключения пока не объявлена, но и вернуться на неё нельзя: старый ID ведёт на ту же 3.8.

Что сделать, если в системе ещё указан `gemini-3.7-flash`:

- найдите ID в коде, переменных окружения, очередях и конфигурации и замените его на `gemini-3.8-flash`, чтобы логи и отчёты показывали модель, которая фактически отвечает;
- прогоните фиксированный набор обычных запросов, задач с длинным контекстом, структурированным ответом и несколькими шагами, включая ошибки инструментов и ожидаемые отказы. Измеряйте долю успеха с первой попытки, правильность вызовов инструментов, медиану и 95-й процентиль времени ответа, расход токенов, повторы и нарушения заданных ограничений. Если раньше вы не сравнивали 3.7 и 3.8, расхождения с прежними метриками объясняются сменой модели под старым ID;
- проверьте расходы. Какую цену Google применяет к запросам на устаревший ID, документация не уточняет. Мы ожидаем тариф 3.8 Flash, который до конца 2026 года совпадает с прежней ценой 3.7, но это наш вывод: сверьте строки по SKU в отчётах Cloud Billing;
- заранее выберите резерв на случай регрессии. Откат на 3.7 больше невозможен; ближайшая альтернатива в той же линейке — `gemini-3.6-flash` с той же ценой. Храните ID модели в конфигурации, чтобы переключение не требовало релиза.

![Схема поэтапного внедрения с английскими подписями: планирование, оценка, поэтапное расширение, мониторинг, метрики и конфигурация; показанный на ней откат на 3.7 Flash с 8 октября 2026 года невозможен, потому что её запросы идут на 3.8](https://www.aifreeapi.com/posts/ru/gemini-3-8-flash/img/safe-rollout-cycle.webp)

Для выбора между Flash-Lite, Flash и Pro используйте отдельный [обзор текстовых моделей Gemini](/ru/posts/gemini-3-0-api). Здесь рассмотрены характеристики Gemini 3.8 Flash и переход на эту модель.

## Вывод

`gemini-3.8-flash` — стабильная и доступная API-модель. Её разумно тестировать для длительной разработки ПО, автономных агентов, сложных инструментов и большого контекста. Учитывайте опубликованное удвоение цены в 2027 году и расширяйте трафик только после измеримого выигрыша. Если в конфигурации остался `gemini-3.7-flash`, вы уже работаете на 3.8 — укажите новый ID явно и проверьте метрики.
