Gemini API — это программный доступ к моделям Google Gemini: ключ GEMINI_API_KEY, SDK google-genai и вызов Interactions (client.interactions.create). Фокус-ключ: gemini api. Канон: Docs и Quickstart. Соседи: OpenAI API, Anthropic API, OpenRouter, ИИ-автоматизация. Чат-гайд для UI — отдельно: как пользоваться Gemini.

Ниже — маршрут разработчика: ключ в AI Studio → SDK → один Interaction. Model id и квоты сверяйте на дату запуска; рублевый прайс не фиксируем.

Три пути интеграции

Путь Суть Старт Когда
Interactions API default с июня 2026 client.interactions.create новые проекты
REST без SDK POST …/v1beta/interactions любой язык / быстрый тест
JS SDK @google/genai npm install @google/genai Node / фронт-бэкенд
generateContent legacy, ещё поддерживается старые туториалы миграция на Interactions
Managed Agents агент с remote environment agent=… + environment исследование + файлы в песочнице

Источник: ai.google.dev/gemini-api/docs (Interactions default June 2026, generateContent legacy); quickstart (GEMINI_API_KEY, pip install -U google-genai, model gemini-3.8-flash, REST v1beta/interactions). Сверка: 2026-10-11. ₽ не выдумываем.

Первый вызов на Python

  1. Создайте API key в Google AI Studio.
  2. Экспортируйте: export GEMINI_API_KEY=….
  3. Поставьте SDK: pip install -U google-genai.
  4. Вызовите Interactions с model id из quickstart (сейчас в примерах — gemini-3.8-flash).
  5. Для прода смотрите rate limits, billing/paid tier и актуальный каталог моделей в Studio.
export GEMINI_API_KEY="YOUR_API_KEY"
pip install -U google-genai

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",  # сверяйте каталог на дату запуска
    input="Explain how AI works in a few words",
)
print(interaction.output_text)

Без SDK: POST https://generativelanguage.googleapis.com/v1beta/interactions с заголовком x-goog-api-key: $GEMINI_API_KEY и телом {"model":"gemini-3.8-flash","input":"…"}. Ключ держите в env, не в репозитории.

Типичные ошибки

  • Путать чат в UI Gemini и Gemini API — разные сценарии и ключи доступа.
  • Копировать устаревший generateContent-туториал без сверки с Interactions (default с 2026).
  • Фиксировать model id навсегда — в quickstart сейчас gemini-3.8-flash, каталог меняется.
  • Коммитить GEMINI_API_KEY в git или в публичный фронтенд.
  • Выдумывать рублевые тарифы — смотрите AI Studio Usage и Cloud Billing.

FAQ: Gemini API

Что такое Gemini API простыми словами?

Gemini API — это HTTP/SDK доступ к моделям Google Gemini для текста, мультимодальности и агентов. Ключ GEMINI_API_KEY, клиент google-genai, с июня 2026 по умолчанию Interactions API. Канон: ai.google.dev/gemini-api/docs.

Чем эта статья отличается от гайда «как пользоваться Gemini»?

Тот материал (пост про чат/UI) — про старт в интерфейсе. Здесь фокус на API: ключ, SDK, Interactions, REST. Разные intent и focus_keyword: gemini api.

Какой SDK и модель для первого вызова?

pip install -U google-genai, затем client.interactions.create(model=»gemini-3.8-flash», input=…). Model id сверяйте в AI Studio/доке на дату запуска — каталог обновляется.

generateContent ещё работает?

Да, но в доке Google он помечен как legacy. Для новых проектов рекомендуют Interactions API (default с июня 2026). Миграция описана в разделе Interactions.

Какой REST endpoint у Interactions?

POST https://generativelanguage.googleapis.com/v1beta/interactions с заголовком x-goog-api-key: $GEMINI_API_KEY и JSON model/input. Пример — в quickstart.

Есть ли цены в рублях в статье?

Нет. Лимиты и биллинг смотрите в Google AI Studio / Cloud Billing. Paid tier требует billing и prepaid credits по доке; рубли не фиксируем.

Вывод

Gemini API — ключ в env, google-genai, один Interaction на актуальной Flash-модели. Старт: Quickstart → свой скрипт → сверка лимитов. Когда нужна система обучения под интеграции — форматы на странице обучения.

Артём Денисов — эксперт Нетологии и автор курса Яндекс Практикума по промпт-инжинирингу. Сверяет Gemini API с официальной докой на дату публикации.

Хотите нейросети под свои задачи, а не «для всех»?

Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Соседи по стеку — ИИ-автоматизация и OpenAI API.