Начало работы

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

API для взаимодействия доступен через SDK для Python и JavaScript , а также через REST.

1. Получите ключ API.

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

  • Google AI Studio автоматически создает проект и ключ API для новых пользователей. Вы можете скопировать его со страницы ключей API .
  • Если вам нужен новый ключ, нажмите «Создать ключ API» в AI Studio и следуйте инструкциям в диалоговом окне, чтобы добавить новую пару «ключ-проект».

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

Установите свой ключ в качестве переменной окружения:

export GEMINI_API_KEY="YOUR_API_KEY"

Перейдите на платный тариф

Переход на платный тариф увеличивает лимиты трафика и требует настройки облачной оплаты.

  • На страницах ключей API AI Studio или проектов нажмите «Настроить выставление счетов» .
  • В диалоговом окне «Облачные платежи» создайте или свяжите платежный аккаунт, добавьте способ оплаты и внесите предоплату в размере не менее 5 долларов США (или эквивалентной суммы в другой валюте).
  • Просматривайте использование API в Google AI Studio в разделе «Панель управления» > «Использование» .

Дополнительную информацию см. на странице «Оплата» .

2. Установите SDK и совершите свой первый звонок.

Установите SDK и генерируйте текст одним вызовом API.

Python

Установите SDK:

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)

JavaScript

Установите SDK:

npm install @google/genai

Инициализируйте клиент и отправьте запрос:

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const interaction = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);

Java 

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = new Client();

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(InteractionsInput.of("Explain how AI works in a few sentences."))
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

ОТДЫХ 

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Explain how AI works in a few words"
  }'

Ответ:

{
  "id": "v1_ChdpQUFvYXI...",
  "status": "completed",
  "usage": {
    "total_tokens": 197,
    "total_input_tokens": 8,
    "total_output_tokens": 12
  },
  "created": "2026-06-09T12:01:25Z",
  "steps": [
    {
      "type":