Чтобы использовать API Gemini, вам понадобится ключ API. Создать ключ можно одним кликом в Google AI Studio.
Подтвердите свой ключ 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 для конкретного языка.
Чтобы ознакомиться с некоторыми общими рекомендациями, вы также можете просмотреть эту статью поддержки .
Следующие шаги
- Ознакомьтесь с краткими руководствами по API , чтобы узнать лучшие практики по обеспечению безопасности ключа API и его использованию.