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

Google объявил общедоступный выпуск Gemini 3.8 Flash 2 сентября 2026 года. Журнал изменений Gemini API. Точный ID в Gemini Developer API — gemini-3.8-flash. Google называет её своей самой интеллектуальной Flash-моделью для длительной разработки ПО, автономных агентов и сложных корпоративных процессов.

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

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

По странице модели:

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

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

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

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

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

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

Цены Gemini 3.8 Flash

Официальные цены указаны в долларах за 1 млн токенов. В цену вывода входят токены рассуждений.

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

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

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

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

Текущее руководство по генерации текста использует Interactions API:

from google import genai

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

REST-вариант:

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 просит обновить строку модели (журнал изменений). В графике вывода моделей из эксплуатации для 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 модели в конфигурации, чтобы переключение не требовало релиза.

Для выбора между Flash-Lite, Flash и Pro используйте отдельный обзор текстовых моделей Gemini. Здесь рассмотрены характеристики Gemini 3.8 Flash и переход на эту модель.

Вывод

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