Гайд · TNWS AI

Как сделать первый запрос к Gemini Interactions API: рабочий пример на JavaScript

2 мин

Первый запрос к рекомендованному 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

Читайте также

Комментарии

Пока тихо. Скажите первое слово