Библиотеки API Gemini

При разработке с использованием API Gemini мы рекомендуем использовать SDK Google GenAI . Это официальные, готовые к использованию библиотеки, которые мы разрабатываем и поддерживаем для самых популярных языков программирования. Они находятся в режиме общего доступа и используются во всей нашей официальной документации и примерах.

Если вы впервые работаете с API Gemini, воспользуйтесь нашим руководством по быстрому запуску , чтобы начать работу.

Языковая поддержка и установка

SDK Google GenAI доступен для языков Python, JavaScript/TypeScript, Go и Java. Вы можете установить библиотеку для каждого языка с помощью менеджеров пакетов или посетить их репозитории на GitHub для более подробного ознакомления:

Python

Библиотека: google-genai
Репозиторий GitHub: googleapis/python-genai
Установка: pip install google-genai

JavaScript

Библиотека: @google/genai
Репозиторий GitHub: googleapis/js-genai
Установка: npm install @google/genai

Идти

Библиотека: google.golang.org/genai
Репозиторий GitHub: googleapis/go-genai
Установка: go get google.golang.org/genai

Java

Библиотека: google-genai
Репозиторий GitHub: googleapis/java-genai
Установка: Если вы используете Maven, добавьте следующее в ваши зависимости:

<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

C#

Библиотека: Google.GenAI
Репозиторий GitHub: googleapis/dotnet-genai
Установка: dotnet add package Google.GenAI

Общая доступность

Мы начали внедрение Google GenAI SDK, нового набора библиотек для доступа к API Gemini, в конце 2024 года, когда запустили Gemini 2.0.

По состоянию на май 2025 года они достигли статуса общедоступных (GA) на всех поддерживаемых платформах и являются рекомендуемыми библиотеками для доступа к API Gemini. Они стабильны, полностью поддерживаются для использования в производственной среде и активно обновляются. Они предоставляют доступ к новейшим функциям и обеспечивают наилучшую производительность при работе с Gemini.

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

Устаревшие библиотеки и миграция

Если вы используете одну из наших устаревших библиотек, мы рекомендуем перейти на новые библиотеки .

Устаревшие библиотеки не предоставляют доступ к новейшим функциям (таким как Live API и Veo ) и находятся на пути к устареванию. Они перестанут получать обновления 30 ноября 2025 года, пробелы в функциональности будут расти, а потенциальные ошибки могут больше не исправляться.

Статус поддержки каждой устаревшей библиотеки различен и подробно описан в следующей таблице:

Язык	Библиотека наследия	Статус поддержки	Рекомендуемая библиотека
Python	`google-generativeai`	Поддержка, включая исправление ошибок, прекращается 30 ноября 2025 года.	`google-genai`
JavaScript/TypeScript	`@google/generativeai`	Поддержка, включая исправление ошибок, прекращается 30 ноября 2025 года.	`@google/genai`
Идти	`google.golang.org/generative-ai`	Поддержка, включая исправление ошибок, прекращается 30 ноября 2025 года.	`google.golang.org/genai`
Дарт и Флаттер	`google_generative_ai`	Активная поддержка отсутствует.	Используйте проверенные библиотеки сообщества или сторонних разработчиков, например firebase_ai , или получите доступ через REST API.
Быстрый	`generative-ai-swift`	Активная поддержка отсутствует.	Используйте логику искусственного интеллекта Firebase.
Андроид	`generative-ai-android`	Активная поддержка отсутствует.	Используйте логику искусственного интеллекта Firebase.

Примечание для Java-разработчиков: для API Gemini не существовало устаревшего Java SDK, предоставляемого Google, поэтому миграция с предыдущей библиотеки Google не требуется. Вы можете начать работу непосредственно с новой библиотекой в разделе « Поддержка языков и установка» .

Шаблоны подсказок для генерации кода

Генеративные модели (например, Gemini, Claude) и IDE для ИИ (например, Cursor) могут генерировать код для API Gemini, используя устаревшие или нерекомендуемые библиотеки из-за ограничения объема обучающих данных. Чтобы сгенерированный код использовал новейшие рекомендуемые библиотеки, укажите версию и рекомендации по использованию непосредственно в подсказках. Вы можете использовать приведенные ниже шаблоны для предоставления необходимого контекста: