Быстрый старт с Gemini API

В этом кратком руководстве показано, как установить наши библиотеки и выполнить первый запрос к Gemini API с помощью Interactions API.

Прежде чем начать

Для использования API Gemini вам потребуется ключ API, который позволит аутентифицировать ваши запросы, устанавливать ограничения безопасности и отслеживать использование в рамках вашей учетной записи.

Для начала создайте учетную запись бесплатно в AI Studio:

Создайте ключ API Gemini

Установите Google GenAI SDK.

pip install -q -U google-genai

npm install @google/genai

Сделайте свой первый запрос

Для отправки запроса к API Gemini можно использовать два способа:

• (Рекомендуется) API взаимодействий — это новый примитив с нативной поддержкой многошагового использования инструментов, оркестровки и сложных потоков рассуждений посредством типизированных шагов выполнения. В дальнейшем новые модели, выходящие за рамки основного семейства, а также новые возможности и инструменты для работы с агентами будут запускаться исключительно через API взаимодействий.
• generateContent предоставляет способ генерации простого ответа без сохранения состояния от модели. Хотя мы рекомендуем использовать Interactions API, generateContent полностью поддерживается.

В этом примере используется API Interactions для отправки запроса к API Gemini с помощью модели Gemini 3 Flash.

Если вы зададите свой API-ключ в качестве переменной окружения GEMINI_API_KEY , он будет автоматически распознан клиентом при использовании библиотек API Gemini . В противном случае вам потребуется передать свой API-ключ в качестве аргумента при инициализации клиента.

Обратите внимание, что все примеры кода в документации по API Gemini предполагают, что у вас установлена ​​переменная среды GEMINI_API_KEY .

# This will only work for SDK newer than 2.0.0
from google import genai

# The client gets the API key from the environment variable `GEMINI_API_KEY`.
client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview", 
    input="Explain how AI works in a few words"
)

# Print the model's text response
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)

// This will only work for SDK newer than 2.0.0
import { GoogleGenAI } from "@google/genai";

// The client gets the API key from the environment variable `GEMINI_API_KEY`.
const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Explain how AI works in a few words",
  });

  const modelStep = interaction.steps.find(s => s.type === 'model_output');
  if (modelStep) {
    for (const contentBlock of modelStep.content) {
      if (contentBlock.type === 'text') console.log(contentBlock.text);
    }
  }
}

main();

# Specifies the API revision to avoid breaking changes when they become default
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Api-Revision: 2026-05-20" \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "Explain how AI works in a few words"
  }'

Безсостоятельный режим

По умолчанию API взаимодействий управляет состоянием диалога на стороне сервера при использовании previous_interaction_id . Если вы предпочитаете управлять историей диалога самостоятельно на стороне клиента, вы можете переключиться в режим без сохранения состояния, установив параметр store=false и передавая накопленные шаги в поле input последующих запросов.

Подробную информацию и полные примеры многошаговой генерации текста без сохранения состояния см. в руководстве по генерации текста .

Что дальше?

После того, как вы отправили свой первый API-запрос, вам может быть полезно ознакомиться со следующими руководствами, демонстрирующими работу Gemini:

• Генерация текста
• генерация изображений
• понимание изображений
• Мышление
• Вызов функции
• Длинный контекст
• Эмбеддинги