Получить ключ API

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

Получить ключ API

Подтвердите свой ключ API с помощью команды Curl.

Вы можете использовать команду Curl для проверки вашей настройки. Вы можете передать ключ API либо в URL-адресе:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent?key=${API_KEY}"

Или в заголовке x-goog-api-key :

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -H "x-goog-api-key: ${API_KEY}" \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent"

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

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

  • API Google AI Gemini использует ключи API для авторизации. Если другие люди получат доступ к вашему ключу API Gemini, они смогут совершать вызовы, используя квоту вашего проекта, что может привести к потере квоты или дополнительным расходам по счетам (если выставление счетов включено). Ключи API также защищают доступ к настроенным моделям и файлам.

  • Нажимая «Получить ключ API» в Google AI Studio, вы выбираете, предоставлять ли ключ Gemini API в новом или существующем проекте Google Cloud. Список ключей API в Google AI Studio показывает все ключи API, которые AI Studio предоставила для использования с API Google AI Gemini (вместе со всеми связанными с ними проектами Google Cloud).

    • Однако любые ключи API в проекте Google Cloud потенциально могут использоваться для вызова API Google AI Gemini. Вы можете просматривать все ключи API вашего проекта и управлять ими на панели API и сервисы > Учетные данные в консоли Google Cloud.

  • Добавление ограничений на ключи API может помочь ограничить площадь поверхности, которую можно использовать с помощью каждого ключа API. По умолчанию ключ Gemini API, созданный Google AI Studio, можно использовать только с Google AI Gemini API (официально называемым «Generative Language API» или generativelanguage.googleapis.com ).

    • Если в вашем проекте Google Cloud есть какие-либо ключи API, для которых отсутствуют ограничения API, или какие-либо ключи API, внесенные в разрешенный список API генеративного языка, то эти ключи можно использовать с API Google AI Gemini. Рекомендуется ограничить каждый ключ API только теми API, которые вы вызываете с помощью этого ключа.
    • Обратите внимание, что даже при наличии ограничений на ключи API, если злоумышленник получит ваш ключ API, он сможет использовать его для выполнения вызовов с использованием квоты вашего проекта для всех API, включенных в разрешенный список для этого ключа API.

  • Вы несете ответственность за безопасность своего ключа API Gemini.

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

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

Следующие шаги