Gemini API

API Gemini — это самый быстрый путь от запроса до внедрения в производство с использованием Gemini, Veo, Nano Banana и других платформ. Он позволяет интегрировать эти генеративные модели в ваши приложения для генерации текста и изображений, анализа мультимодальных входных данных и создания диалоговых агентов.

Python

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

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.7-flash"))
        .input(InteractionsInput.of("Explain how AI works in a few words"))
        .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"
  }'

Познакомьтесь с моделями

Просмотреть все

Изучите возможности

Генерация изображений

Создавайте и редактируйте изображения с высоким контекстом непосредственно в Nano Banana.

Длинный контекст

Вводите миллионы токенов в модели Gemini и извлекайте информацию из неструктурированных изображений, видео и документов.

Структурированные выходные данные

Настройте Gemini на отправку данных в формате JSON — структурированном формате, подходящем для автоматической обработки.

Вызов функции

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

Создание видео с помощью Veo 3.1

Создавайте высококачественный видеоконтент на основе текстовых или графических подсказок с помощью нашей современной модели.

Голосовые агенты с API в реальном времени

Создавайте голосовые приложения и агентов в режиме реального времени с помощью Live API.

Инструменты

Подключите Gemini к миру с помощью встроенных инструментов, таких как поиск Google, контекст URL, Google Maps, выполнение кода и использование компьютера.

Понимание документа

Обрабатывайте до 1000 страниц PDF-файлов с полным пониманием мультимодальных данных или других текстовых типов файлов.

Мышление

Изучите, как мыслительные способности улучшают способность к рассуждению при решении сложных задач и работе со сложными агентами.

Создать агентов

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

Python

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-09-2026",
    input=(
        "Research the top 5 sustainable fashion brands, "
        "compare their materials and pricing tiers, and "
        "build an interactive dashboard in analysis.html."
    ),
    environment="remote"
)

print(interaction.output_text)

JavaScript

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

const ai = new GoogleGenAI({});

const interaction = await ai.interactions.create({
  agent: "antigravity-preview-09-2026",
  input:
    "Research the top 5 sustainable fashion brands, " +
    "compare their materials and pricing tiers, and " +
    "build an interactive dashboard in analysis.html.",
  environment: "remote",
});

console.log(interaction.output_text);

Java

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.AgentOption;
import com.google.genai.gaos.models.interactions.CreateAgentInteraction;
import com.google.genai.gaos.models.interactions.CreateAgentInteractionEnvironment;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = new Client();

CreateAgentInteraction params =
    CreateAgentInteraction.builder()
        .agent(AgentOption.of("antigravity-preview-09-2026"))
        .input(
            InteractionsInput.of(
                "Research the top 5 sustainable fashion brands, "
                    + "compare their materials and pricing tiers, and "
                    + "build an interactive dashboard in analysis.html."))
        .environment(CreateAgentInteractionEnvironment.of("remote"))
        .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 '{
    "agent": "antigravity-preview-09-2026",
    "input": "Research the top 5 sustainable fashion brands, compare their materials and pricing tiers, and build an interactive dashboard in analysis.html.",
    "environment": "remote"
  }'

API взаимодействий

API взаимодействия стал нашим интерфейсом по умолчанию с июня 2026 года и является лучшим способом построения моделей и агентов Gemini в будущем. Если вы начинаете новый проект, вам следует использовать API взаимодействия. Хотя он по-прежнему поддерживается, API generateContent теперь считается устаревшим.

Обзор взаимодействий

Узнайте, как API взаимодействий управляет состоянием диалога, сообщениями и форматами вывода.

Руководство по миграции

Пошаговое руководство по переходу вашего кода с generateContent на Interactions API.

Стриминг

Передавайте токены в реальном времени, разворачивающиеся мысли и события вызова инструментов.

Google AI Studio

Тестируйте запросы, управляйте ключами API, отслеживайте использование и создавайте прототипы.

Сообщество разработчиков

Задавайте вопросы и находите решения у других разработчиков и инженеров Google.

Справочник API

Подробную информацию об API Gemini можно найти в официальной справочной документации.

Статус

Проверьте статус Gemini API, Google AI Studio и наших сервисов моделей.