В этой документации по API описаны унарные, потоковые и работающие в реальном времени API, которые можно использовать для взаимодействия с моделями Gemini. REST API можно использовать в любой среде, поддерживающей HTTP-запросы. Информацию о том, как выполнить первый вызов API, можно найти в кратком руководстве по началу работы. Если вам нужны справочные материалы по библиотекам и SDK для конкретных языков, перейдите по ссылке для нужного языка в разделе Справочные материалы по SDK на панели навигации слева.
Основные конечные точки
Gemini API работает со следующими основными конечными точками:
- Interactions (
CreateInteraction) (рекомендуется). Рекомендуемый стандартный примитив для создания приложений с Gemini, оптимизированный для рабочих процессов агентов, управления состоянием на стороне сервера и сложных мультимодальных многоэтапных разговоров. - Стандартное создание контента (
generateContent). Стандартная конечная точка REST, которая обрабатывает запрос и возвращает полный ответ модели в одном пакете. Это лучше всего подходит для неинтерактивных задач, где вы можете дождаться всего результата. - Генерация контента в потоковом режиме (
streamGenerateContent). Использует события, отправляемые сервером (SSE), чтобы передавать вам фрагменты ответа по мере их генерации. Это позволяет быстрее и эффективнее взаимодействовать с такими приложениями, как чат-боты. - Live API (
BidiGenerateContent). API на основе WebSocket с сохранением состояния для двунаправленной потоковой передачи, предназначенный для общения в реальном времени. - Пакетный режим (
batchGenerateContent). Стандартная конечная точка REST для отправки пакетов запросовgenerateContent. - Эмбеддинги (
embedContent). Стандартная конечная точка REST, которая генерирует вектор эмбеддинга текста из входных данныхContent. - Gen Media API. Конечные точки для генерации медиаконтента с помощью наших специализированных моделей, таких как Imagen для создания изображений и Veo для создания видео.
Эти возможности также встроены в Gemini, и вы можете получить к ним доступ с помощью
generateContentAPI. - API платформы. Конечные точки, поддерживающие основные функции, такие как загрузка файлов и подсчет токенов.
Аутентификация
Все запросы к Gemini API должны содержать заголовок x-goog-api-key с вашим ключом API. Создайте его в Google AI Studio.
Ниже приведен пример запроса с ключом API в заголовке.
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"
}'
Инструкции о том, как передать ключ в API с помощью Gemini SDK, можно найти в руководстве Использование ключей Gemini API.