Получите ключ API Gemini

Чтобы использовать API Gemini, вам понадобится ключ API. Вы можете создать ключ в несколько кликов в Google AI Studio.

Получите ключ API Gemini в Google AI Studio.

Настройте свой ключ API

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

Linux/macOS — Баш

Bash — это стандартная конфигурация терминала Linux и macOS. Вы можете проверить, есть ли у вас файл конфигурации, выполнив следующую команду:

~/.bashrc

Если ответ «Нет такого файла или каталога», вам нужно будет создать этот файл и открыть его, выполнив следующие команды, или использовать zsh :

touch ~/.bashrc
open ~/.bashrc

Далее вам необходимо установить ключ API, добавив следующую команду экспорта:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

После сохранения файла примените изменения, выполнив:

source ~/.bashrc

macOS — Зш

Zsh — это стандартная конфигурация терминала Linux и macOS. Вы можете проверить, есть ли у вас файл конфигурации, выполнив следующую команду:

~/.zshrc

Если ответ «Нет такого файла или каталога», вам нужно будет создать этот файл и открыть его, выполнив следующие команды, или использовать bash :

touch ~/.zshrc
open ~/.zshrc

Далее вам необходимо установить ключ API, добавив следующую команду экспорта:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

После сохранения файла примените изменения, выполнив:

source ~/.zshrc

Окна

Найдите «Переменные среды» в настройках системы.
Отредактируйте либо «Пользовательские переменные» (для текущего пользователя), либо «Системные переменные» (для всех пользователей — используйте с осторожностью).
Создайте переменную и добавьте export GEMINI_API_KEY=your_key_here
Применить изменения

Отправьте свой первый запрос Gemini API

Вы можете использовать команду Curl для проверки вашей настройки:

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

Храните свой ключ API в безопасности

Важно обеспечить безопасность вашего ключа Gemini API. Вот несколько вещей, которые следует учитывать при использовании ключа Gemini API:

API Google AI Gemini использует ключи API для авторизации. Если другие люди получат доступ к вашему ключу API Gemini, они смогут совершать вызовы, используя квоту вашего проекта, что может привести к потере квоты или дополнительным расходам за проекты с выставленными счетами, а также к доступу к настроенным моделям и файлам.
Добавление ограничений на ключи API может помочь ограничить область использования каждого ключа API.
Вы несете ответственность за безопасность своего ключа API Gemini.
- НЕ проверяйте ключи API Gemini в системе контроля версий.
- Клиентские приложения (Android, Swift, веб и Dart/Flutter) рискуют раскрыть ключи API. Мы не рекомендуем использовать клиентские SDK Google AI в рабочих приложениях для вызова API Google AI Gemini непосредственно из мобильных и веб-приложений.

Чтобы ознакомиться с некоторыми общими рекомендациями, вы также можете просмотреть эту статью поддержки .