Новый API Gemini по умолчанию: агенты, фоновые процессы и медиа

Google DeepMind объявила, что Interactions API стал новым API по умолчанию для моделей и агентов Gemini. Interactions API вышел из беты (запущенной в декабре 2025) и достиг статуса GA (июнь 2026). Теперь это новый вариант по умолчанию в Google AI Studio и документации разработчика Google. Вы всё ещё можете пользоваться generateContent API, если хотите продолжать использовать его в своих текущих проектах и интеграциях. Однако Google чётко заявила, что все будущие функции агентов будут доступны только через Interactions API. Так что если вы планируете строить что-то на новейших возможностях Gemini, не отставайте со старым API.

В целом Interactions API отличается от generateContent API тем, как он структурирует диалоги и действия. В generateContent API диалог построен на ролях, где каждое сообщение помечено либо как «user», либо как «model». Это создаёт двусторонний поток общения. Interactions API, напротив, использует типизированный, пошаговый диалог, где каждое действие (ввод пользователя, вызов инструмента, возврат функции, ответ модели) рассматривается как самостоятельный шаг со своим типом. Для простых чатов особой разницы это не даёт, но зато сильно упрощает сложные агентные сценарии с несколькими инструментами и последовательными операциями. С типизированными шагами выражать и масштабировать такие агентные сценарии становится куда проще.

1Что открывает новый API

Interactions API открывает мощные возможности, которых раньше просто не было. С Linux-песочницами агенты теперь получают доступ к настоящей оболочке, а не просто к имитации вызова инструмента. Они могут выполнять команды в изолированной среде. Фоновые задачи позволяют агентам запускать длительные операции асинхронно — то есть запустить задачу, дать агенту работать часами, пока вы занимаетесь другими делами, а потом забрать результат. Встроенные цепочки инструментов с Google Search и Maps позволяют агентам нативно связывать инструменты между собой без внешней интеграции. Генерация медиа (изображений, музыки и речи) теперь может происходить нативно прямо в теле ответа, без отдельных вызовов API.

Ещё один момент, который стоит учесть, — модель ценообразования. Interactions API предлагает два режима работы — Flex и Priority. В режиме Flex вы платите 50% от обычной цены за вычисления, но используете оборудование с более низким приоритетом, что идеально подходит для фоновых задач и пакетной обработки, устойчивых к более высокой задержке. В режиме Priority вы платите полную цену, но получаете более высокую пропускную способность и меньшую задержку, что отлично подходит для взаимодействия с агентом в реальном времени. Если у вас есть агентные задачи, которые нужно прогонять ночью без присмотра, вы можете сэкономить половину стоимости вычислений, переключившись на режим Flex, не жертвуя при этом качеством. Если же взаимодействие с агентом требует низкой задержки и ждать нельзя, тогда рекомендуется режим Priority.