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

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

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

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

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

Python

JavaScript

Идти

Java

  • Library: 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

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

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

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

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

If you are using one of our legacy libraries, we recommend that you migrate to the new libraries .

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

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

Язык Библиотека наследия Статус поддержки Рекомендуемая библиотека
Python google-generativeai Не поддерживается в активном режиме. google-genai
JavaScript/TypeScript @google/generativeai Не поддерживается в активном режиме. @google/genai
Идти google.golang.org/generative-ai Не поддерживается в активном режиме. google.golang.org/genai
Дарт и Флаттер google_generative_ai Не поддерживается в активном режиме. Use trusted community or third party libraries, like firebase_ai , or access using REST API
Быстрый generative-ai-swift Не поддерживается в активном режиме. Используйте логику искусственного интеллекта Firebase.
Android generative-ai-android Не поддерживается в активном режиме. Используйте логику искусственного интеллекта Firebase.

Note for Java developers: There was no legacy Google-provided Java SDK for the Gemini API, so no migration from a previous Google library is required. You can start directly with the new library in the Language support and installation section.

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

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