Гайд · TNWS AI
Как сделать первый запрос к Gemini Interactions API: рабочий пример на JavaScript
Первый запрос к рекомендованному Gemini Interactions API: установка SDK, ключ, interaction.output_text, хранение данных и проверка ошибок.
Для нового проекта используйте Interactions API: Google объявила его общедоступным и рекомендуемым интерфейсом в июне 2026 года. Минимальный запрос состоит из модели и input; готовый текст читается из output_text, а полный объект interaction содержит шаги выполнения и идентификатор продолжения.
Рабочий пример
npm install @google/genai
export GEMINI_API_KEY="ваш_ключ"
// index.mjs import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({}); const interaction = await ai.interactions.create({ model: "gemini-3.8-flash", input: "Верни три критерия проверки SEO-заголовка.", store: false });
console.log(interaction.output_text); console.log(interaction.id);
## Что означает каждая важная часть
- `GoogleGenAI({})` читает `GEMINI_API_KEY` из окружения. Ключ не должен попадать в браузерный bundle.
- `model` нужно брать из текущего каталога моделей. В примере используется имя из официальной документации на 11 сентября 2026 года.
- `input` подходит для простой строки. Для мультимодального запроса передают типизированные блоки содержимого.
- `store:false` делает пример без сохранения состояния на стороне API; для управляемой беседы это поле можно не задавать и использовать `previous_interaction_id`.
- `output_text` — удобное агрегированное текстовое представление. Для инструментов и мультимодальных ответов разбирайте `steps`, а не только эту строку.
## Порядок внедрения
1. Создайте API-ключ в Google AI Studio и задайте его переменной окружения `GEMINI_API_KEY`.
2. Сохраните пример как `index.mjs` и выполните `node index.mjs`.
3. Проверьте, что напечатан непустой ответ и идентификатор interaction.
4. Добавьте обработчик исключений: логируйте HTTP-статус и request ID, но не ключ и полный пользовательский ввод.
## Как проверить результат
Отправьте задачу с машинно проверяемым условием: «верни ровно три строки, каждая начинается с дефиса». Проверьте количество строк программно. Затем временно подставьте неправильное имя модели: приложение должно показать ошибку API, а не записать пустую строку как успешный ответ.
## Ограничения
По умолчанию Interactions API хранит запросы, чтобы поддерживать серверное состояние. Если это не подходит политике данных, явно задайте `store:false`. Доступность моделей, инструментов и регионов меняется; проверяйте страницу Models и Console. Старый `generateContent` продолжает поддерживаться, поэтому срочно переписывать стабильную интеграцию без причины не требуется.
## Чего не делать
- Не вставляйте постоянный API-ключ в фронтенд.
- Не считайте
output_textединственным возможным типом результата. - Не фиксируйте preview-модель навсегда без плана обновления.
Частые вопросы
Можно ли использовать пример в production?
Как основу — да, но добавьте авторизацию, таймауты, обработку ошибок, лимиты и тесты из статьи.
Где проверять актуальное имя модели?
В официальном каталоге Gemini API и Google AI Studio непосредственно перед развёртыванием.
Нужно ли доверять ответу без проверки?
Нет. Формат проверяется кодом, а важные факты — источником или вашей базой данных.
Что делать при изменении API?
Зафиксировать версию SDK, прочитать release notes и прогнать сохранённый набор интеграционных тестов.
Официальный источник
Документация Google, проверена 11 сентября 2026 года: https://ai.google.dev/gemini-api/docs/interactions-overview
Читайте также
Как перейти с generateContent на Gemini Interactions API и не сломать приложение
Практическая миграция Gemini API: соответствие contents и input, история через previous_interaction_id, store:false и поэтапная проверка.
Как продолжить диалог в Gemini API через previous_interaction_id
Серверное состояние Gemini Interactions API: создание первого хода, previous_interaction_id, ветвление диалога и защита от смешивания пользователей.
Как настроить function calling в Gemini API и не выполнить опасную команду
Описание функции для Gemini, чтение аргументов, allowlist, подтверждение операции и возврат результата инструменту.
Комментарии
Пока тихо. Скажите первое слово