Gemini 3.5 Flash: возможности, API и переход на 3.6
Для кода, документов и многошаговой работы с инструментами в Gemini Developer API используйте прямой ID gemini-3.6-flash: старый gemini-3.5-flash уже направляет запросы на эту модель. Мультимодальный ввод даёт текстовый ответ; генерация изображений, озвучка и Live требуют других моделей.
Содержание

Gemini 3.5 Flash предназначена для программирования, анализа больших материалов и многошаговой работы с инструментами. Она принимает текст, изображения, видео, аудио и PDF, а возвращает текст. Однако на 14 октября 2026 года в Gemini Developer API запрос с ID gemini-3.5-flash уже автоматически направляется на gemini-3.6-flash. Для новой интеграции указывайте 3.6 напрямую. Это подтверждает страница модели Google.
Практический смысл возможностей сохранился: можно получить объяснение ошибки по коду и снимку экрана, извлечь данные из документа, составить ответ с использованием поиска или связать несколько вызовов функций. Но поддержка входного аудио не означает синтез речи, а вызов функции ещё не означает, что модель сама выполнила действие в вашей системе. Ниже — что можно построить на этих возможностях, как сделать первый запрос и какие условия меняют выбор модели.
Какие задачи можно поручить модели
В карточках 3.5 и её замены 3.6 указаны входной лимит 1 048 576 токенов и максимальный выход 65 536 токенов. Это разные величины: миллион токенов на входе не позволяет получить миллион токенов ответа и не гарантирует, что каждая деталь большого документа будет найдена правильно.
| Задача | Какие возможности пригодятся | Как оценить полезный результат |
|---|---|---|
| Найти причину ошибки в программе | Код, журналы, изображения интерфейса, рассуждение, выполнение кода | Исправление объясняет причину, проходит ваши проверки и не меняет посторонние файлы |
| Извлечь сведения из PDF или скана | PDF и изображения на входе, структурированный ответ | Поля соответствуют исходнику; отсутствующие сведения не подставлены догадкой |
| Разобрать запись встречи или видео | Аудио и видео на входе, текст на выходе | Выводы и цитаты сверяются с исходным материалом |
| Ответить по файлам или свежим сведениям | Поиск по файлам, URL context, привязка к Google Поиску | Источник действительно подтверждает ответ, а приложение сохраняет ссылки |
| Провести задачу через несколько систем | Вызов функций, история диалога, рассуждение | Аргументы корректны, результаты сопоставлены с вызовами, действие разрешено приложением |

Для анализа документов полезно заранее задать проверяемый результат. Например, при разборе накладной попросите вернуть номер, дату, позиции и расхождения с заказом, а отсутствующие значения обозначить как неизвестные. Проверка должна сравнивать результат с накладной, а не только выяснять, получился ли корректный JSON. Поддержка структурированного ответа помогает задать форму, но форма сама по себе не подтверждает факты.
В программировании смысл Flash — в последовательности «изучить материалы → предложить исправление → получить результат проверки → скорректировать решение». Google описывает 3.6 как улучшение относительно 3.5 с меньшим количеством лишних правок, отладочных циклов и вызовов инструментов. Это оценка разработчика модели, а не доказательство одинакового выигрыша на любом проекте. В том же руководстве отмечено, что люди иногда предпочитали прежние модели по оформлению интерфейсов; для такой задачи стоит явно задавать требования к дизайну.
Если работа сводится к короткой классификации или извлечению пары полей из тысяч сообщений, полная Flash может оказаться избыточной. Для этого у Google есть отдельная Flash-Lite. Разбор экономического выбора вынесен в сравнение Flash и Flash-Lite; здесь важнее понять возможности и корректно подключить модель.
Старый API ID работает, но прежнюю 3.5 уже не выбирает
Google объявил изменение 8 октября 2026 года. В Developer API старый адрес не отключается: он автоматически направляет запросы на 3.6. В AI Studio выбрать 3.5 отдельно больше нельзя. Это прямо записано в журнале изменений и таблице прекращения поддержки.
Отсюда два следствия для работающего приложения. Замена строки на gemini-3.6-flash делает конфигурацию понятнее, но не означает первый переход на новую модель: запросы со старой строкой уже могли обслуживаться 3.6. И сравнение gemini-3.5-flash с gemini-3.6-flash сегодня не является независимым тестом прежней и новой моделей. Вернуть прошлое поведение простой заменой ID обратно на 3.5 тоже нельзя.
У Google Cloud другой жизненный цикл. В карточке Gemini Enterprise Agent Platform модель gemini-3.5-flash по-прежнему имеет статус GA, дату выпуска 19 мая 2026 года и дату прекращения поддержки 19 мая 2027 года или позднее. Та же карточка поддерживает GenerateContent и Chat Completions, но не Interactions и Live. Сноска отдельно оговаривает отличие Cloud от Gemini API. Поэтому октябрьское перенаправление Developer API нельзя переносить на Cloud без проверки. Источник: модель 3.5 в Cloud.
Если вопрос связан с IAM, сервисными аккаунтами, регионами обработки и централизованным биллингом, следующий шаг — выбор между Gemini Developer API и Vertex AI API. Название модели не заменяет выбор способа авторизации и условий эксплуатации.
Где нужны другие модели: картинки, голос и управление интерфейсом
3.5 и 3.6 Flash не генерируют изображения или аудио и не поддерживают Live API. Они могут проанализировать фотографию или запись и ответить текстом. Для картинки на выходе нужна модель генерации изображений, для чтения текста вслух — TTS, для двустороннего голосового взаимодействия — модель Live. Эти ограничения указаны в карточке 3.6.
С Computer Use ситуация тоньше. Актуальные карточки 3.5 и 3.6 помечают его как Supported (Preview), поэтому старое утверждение «3.5 не поддерживает управление интерфейсом» уже неверно. При этом новое руководство Computer Use рекомендует gemini-3.8-flash и в списке версий перечисляет Argon, 3.8 Flash, 3.5 Flash-Lite и 3 Flash Preview, без 3.6. Отметка в карточке и список для актуальной реализации не совпадают; фактическую совместимость запроса к 3.6 мы не проверяли. Для новой реализации ориентируйтесь на документированный пример с 3.8, а не на предположение о полной взаимозаменяемости.
Computer Use требует приложения, которое передаёт снимок экрана и описание задачи, получает предложенный function_call, исполняет разрешённое действие, затем отправляет новое состояние. Модель предлагает действие; нажимает кнопку ваш клиент. Если получено требование подтверждения, клиент должен запросить его, а при блокировке — остановить действие. Google рекомендует изолированную среду, ограниченные разрешения и наблюдение за важными задачами. Preview не даёт гарантии безошибочной автоматизации.
Первый вызов через нативный Gemini API
Для обычного текстового ответа используйте generateContent. Нужны доступный вам регион обслуживания, проект с доступом к модели и действующий ключ. Россия отсутствует в текущем списке регионов Gemini API и AI Studio; русскоязычный интерфейс или русский запрос этого не меняют. Google отдельно предлагает рассмотреть Cloud, у которого собственные условия доступности. Региональные требования Google.
С 28 мая 2026 года новые ключи AI Studio создаются как ключи авторизации. Неограниченные стандартные ключи API отклоняет; стандартные ключи с явными ограничениями продолжают работать. Проверьте тип имеющегося ключа по документации авторизации, если старая интеграция перестала проходить этот этап.
Ниже самостоятельный пример запроса для разбора ошибки Python. Он следует форме REST API, но не запускался на модели. Для выполнения нужны curl, jq и уже заданная на сервере переменная GEMINI_API_KEY; ключ не помещайте в публичный клиентский код.
curl --fail-with-body \
'https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent' \
-H "x-goog-api-key: ${GEMINI_API_KEY:?Задайте GEMINI_API_KEY на сервере}" \
-H 'Content-Type: application/json' \
--data-binary @- > response.json <<'JSON'
{
"contents": [{
"role": "user",
"parts": [{
"text": "В Python функция def average(values): return sum(values) / len(values) получает пустой список и выдаёт ZeroDivisionError. Предложи исправление, которое явно отклоняет пустой список, и два теста: для пустого списка и для [2, 4]. Не меняй поведение для непустого списка."
}]
}],
"generationConfig": {
"maxOutputTokens": 4096,
"thinkingConfig": {"thinkingLevel": "MEDIUM"}
}
}
JSON
jq '{modelVersion, responseId, usageMetadata, promptFeedback,
finishReasons: [.candidates[]?.finishReason]}' response.json
jq -r '.candidates[]?.content.parts[]? |
select(.text != null and .thought != true) | .text' response.jsonУспех здесь — не просто HTTP 200. В ответе должен быть пригодный текст, объясняющий явное отклонение пустого списка и проверки ожидаемого поведения. Выполнение предложенного кода и тестов остаётся отдельным этапом в вашей среде. Если текста нет, проверьте promptFeedback, причины завершения кандидатов и тело ошибки, прежде чем повторять запрос. Поля modelVersion, responseId и usageMetadata описаны в справочнике generateContent.
Не смешивайте этот запрос с Interactions API. У generateContent используются путь /v1beta/models/{model}:generateContent, contents и generationConfig; у Interactions — /v1beta/interactions, model, input и generation_config. Уровень в нативном REST выше записан как thinkingConfig.thinkingLevel: "MEDIUM", а в Interactions применяется thinking_level: "medium". Формат ответа тоже различается: output_text из примера Interactions не является полем сырого ответа generateContent.
Что проверить при переходе рабочего приложения
Начните с конфигурации и истории запросов, затем оценивайте качество. Руководство по 3.6 перечисляет изменения, которые способны испортить сравнение независимо от полезности модели:
- Уберите
temperature,top_pиtop_k— в 3.6 они устарели и игнорируются; в будущих поколениях могут давать ошибку. В нативном JSON соответствующие поля имеют видtemperature,topP,topK.candidate_countтакже не поддерживается. - Не завершайте запрос непустым сообщением с ролью
model, заранее подставляя начало ответа: это приводит к 400. Форму задавайте инструкцией или структурированным ответом. - Используйте уровень рассуждения вместо числового
thinking_budget. Для 3.6 доступныminimal,low,medium,high, по умолчанию —medium.minimalне гарантирует полного отключения рассуждения. У 3.8 доступны толькоlow,medium,high; переносminimalвызовет ошибку. Таблица уровней. - В многошаговом
generateContentсохраняйте полную неизменённую историю, включая подписи рассуждения. Для ответа на вызов функции сопоставляйтеid,nameи число результатов с полученными вызовами; мультимодальные результаты передавайте внутри ответа функции. Требования к истории и функциям.
В Interactions с store: true и previous_interaction_id сервер сохраняет состояние. При самостоятельной передаче истории надо возвращать все полученные блоки рассуждения без изменений. Это объясняет, почему короткий одношаговый пример может работать, а цепочка с инструментами — ломаться после сокращения истории. Описание сохранения состояния.

Для выбора между прямой 3.6, более новой 3.8 и вашей другой действующей моделью возьмите собственные задачи с известным правильным результатом. При отладке важны лишние правки и пройденные тесты; при извлечении данных — совпадение полей с оригиналом; при вызове функций — правильные аргументы и завершённое действие. Сравнивайте также повторные запросы и время ручной проверки. Это предложенный способ оценки, а не проведённый нами сравнительный тест.
Возврат на другую конфигурацию должен вести к реально доступной альтернативе. Старый ID 3.5 в Developer API таким запасным вариантом не служит: он ведёт к той же 3.6.
Цена запроса: учитывайте рассуждение и режим
На 14 октября 2026 года таблица цен Developer API даёт для 3.6 и 3.8 Flash одинаковые ставки. Ниже цена за миллион токенов в USD; выход включает токены рассуждения.
| Режим | Вход до 31 декабря 2026 года | Выход до 31 декабря 2026 года | Вход с 1 января 2027 года | Выход с 1 января 2027 года |
|---|---|---|---|---|
| Standard | 0,75 | 3,75 | 1,50 | 7,50 |
| Batch / Flex | 0,375 | 1,875 | 0,75 | 3,75 |
| Priority | 1,35 | 6,75 | 2,70 | 13,50 |
Указанные в руководстве 3.6 суммы 1,50/7,50 USD — базовые ставки без периода акции; для текущего расчёта используйте датированную таблицу цен. Отдельного актуального раздела 3.5 Flash в ней нет. Это тарифы прямого Developer API, а не подтверждённый счёт по старому ID, тариф Cloud, подписка Gemini или цена посредника.
Например, предположим, что анализ одного документа расходует 24 000 входных токенов и суммарно 3 000 выходных токенов вместе с рассуждением. Без кеша, инструментов и повторов Standard до конца 2026 года даёт:
24 000 / 1 000 000 × 0,75 + 3 000 / 1 000 000 × 3,75 = 0,02925 USD.
Это расчёт по заданным предположениям, а не измеренная стоимость документа. Если объём рассуждения вырастет или потребуется второй запрос, стоимость изменится. В нативном ответе thoughtsTokenCount учитывает рассуждение отдельно от candidatesTokenCount, а totalTokenCount включает также вход и токены запросов инструментов. Нельзя умножать весь totalTokenCount на ставку выхода. Кешированные токены уже входят в promptTokenCount, поэтому не прибавляйте их повторно. Определения счётчиков.
Кеш и поиск требуют отдельных строк бюджета. В Standard чтение кеша стоит 0,075 USD за миллион токенов, хранение — 0,50 USD за миллион токенов в час до 31 декабря; с января — 0,15 и 1,00 USD соответственно. Для платного поиска есть общий для Gemini 3 и новее месячный бесплатный объём 5 000 запросов, затем ставка 14 USD за 1 000; одно обращение пользователя способно вызвать несколько оплачиваемых поисковых запросов. Все эти единицы и оговорки приведены в ценовой таблице Google.
Бесплатный уровень и лимиты проекта
У прямой 3.6 Flash в Standard указан бесплатный уровень, но фиксированные «1 500 запросов в день» или «15 в минуту» нельзя считать текущей гарантией. Google показывает действующие лимиты в AI Studio; они зависят от модели, уровня проекта и состояния аккаунта. Ограничения действуют на проект, а не на ключ, дневная квота обновляется в полночь по тихоокеанскому времени. Второй ключ того же проекта не удваивает её. Правила лимитов.
При 429 RESOURCE_EXHAUSTED проверьте не только частоту запросов, но и входные токены, дневную квоту и, если применимо к аккаунту, лимит расходов за скользящие десять минут. Указанные Google пороги расходов для Tier 1/2/3 — 10/50/200 USD за это окно; их применение зависит от истории биллинга и состояния аккаунта. Большое контекстное окно модели не отменяет ограничения проекта.
Перед разбором реальных документов учитывайте условия данных. Для неоплачиваемых услуг Google может использовать вход и ответы для улучшения продуктов, в том числе с участием проверяющих людей; конфиденциальные материалы туда передавать не следует. Для Paid Services данные не используются для улучшения продуктов, но это не означает отсутствие временного хранения в целях безопасности. Для ЕЭЗ, Швейцарии и Великобритании действуют отдельные исключения, а предоставление API-приложения пользователям этих рынков требует Paid Services. Условия Gemini API.
Часто задаваемые вопросы
Можно ли ещё вызвать Gemini 3.5 Flash через API?
В Gemini Developer API старый ID остаётся рабочим адресом, но автоматически направляет запросы на 3.6; отдельную прежнюю 3.5 он больше не выбирает. В Cloud опубликован отдельный жизненный цикл 3.5. Проверяйте именно свой способ подключения. Developer API, Cloud.
Gemini 3.5 Flash умеет рисовать и говорить?
Она принимает изображения и аудио, но выдаёт текст. Генерация изображений, синтез аудио и Live API не поддерживаются ни в карточке 3.5, ни у замены 3.6. Для этих результатов нужны специализированные модели. Возможности 3.6 Flash.
Поддерживает ли Flash управление компьютером?
В карточках 3.5 и 3.6 есть Computer Use Preview. Однако актуальное руководство рекомендует 3.8 и не включает 3.6 в свой список версий; совместимость запроса к 3.6 здесь не проверена. Реализация требует собственного обработчика действий и подтверждений, обычного текстового запроса недостаточно. Карточка, руководство Computer Use.
Какое имя у Gemini 3.5 Flash-Lite в API?
gemini-3.5-flash-lite. Это отдельная модель для менее дорогих массовых задач, а не другое название 3.5 Flash и не её автоматическая замена. Для старой 3.5 Flash в Developer API замена — gemini-3.6-flash. Официальное руководство Flash и Flash-Lite.
Где узнать бесплатный лимит и нужен ли особый ключ для 3.5?
Особый ключ для этой модели не нужен: ключ связан с проектом, а действующий лимит выбранной модели смотрите в AI Studio. После перенаправления старого ID ориентируйтесь на фактически используемую модель. Единая гарантированная дневная квота не опубликована, и дополнительные ключи в том же проекте не создают дополнительную ёмкость. Ключи, лимиты.
Стоит ли сразу перейти на 3.8 Flash?
3.8 — актуальная Flash для длительных программных и агентных задач по описанию Google; 3.6 остаётся доступной прямой заменой старого ID. Выбирайте 3.8, когда её документированные возможности нужны вашей интеграции и результат на ваших задачах оправдывает переход. При переносе настроек удалите minimal: 3.8 его не поддерживает. Это условный выбор по документации, без наших замеров качества или задержки. Карточка 3.8.
Источники17
Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 14 окт. 2026 г..
Источники17
Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 14 окт. 2026 г..
- 1.страница модели Googleai.google.dev/gemini-api/docs/models/gemini-3.5-flash
- 2.её замены 3.6ai.google.dev/gemini-api/docs/models/gemini-3.6-flash
- 3.оценка разработчика моделиai.google.dev/gemini-api/docs/whats-new-gemini-3.6
- 4.журнале измененийai.google.dev/gemini-api/docs/changelog
- 5.таблице прекращения поддержкиai.google.dev/gemini-api/docs/deprecations
- 6.Источник: модель 3.5 в Clouddocs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-5-flash
- 7.новое руководство Computer Useai.google.dev/gemini-api/docs/computer-use
- 8.Региональные требования Googleai.google.dev/gemini-api/docs/available-regions
- 9.документации авторизацииai.google.dev/gemini-api/docs/api-key
- 10.справочнике generateContentai.google.dev/api/generate-content
- 11.Таблица уровнейai.google.dev/gemini-api/docs/thinking
- 12.Требования к истории и функциямai.google.dev/gemini-api/docs/whats-new-gemini-3.5
- 13.таблица цен Developer APIai.google.dev/gemini-api/docs/pricing
- 14.AI Studioaistudio.google.com/rate-limit
- 15.Правила лимитовai.google.dev/gemini-api/docs/rate-limits
- 16.Условия Gemini APIai.google.dev/gemini-api/terms
- 17.Карточка 3.8ai.google.dev/gemini-api/docs/models/gemini-3.8-flash





