Uzyskiwanie klucza interfejsu Gemini API

Aby korzystać z interfejsu Gemini API, potrzebujesz klucza API. Klucz możesz utworzyć w kilka kliknięć w Google AI Studio.

Uzyskiwanie klucza interfejsu Gemini API w Google AI Studio

Konfigurowanie klucza interfejsu API

Podczas wstępnego testowania możesz zakodować na stałe klucz interfejsu API, ale powinno to być tylko tymczasowe, ponieważ nie jest to bezpieczne. W dalszej części tej sekcji opisujemy, jak skonfigurować klucz interfejsu API lokalnie jako zmienną środowiskową w różnych systemach operacyjnych.

Linux/macOS – Bash

Bash to popularna konfiguracja terminala w systemach Linux i macOS. Aby sprawdzić, czy masz plik konfiguracji, uruchom to polecenie:

~/.bashrc

Jeśli odpowiedź brzmi „Brak takiego pliku lub katalogu”, musisz utworzyć ten plik i otworzyć go, uruchamiając te polecenia lub używając polecenia zsh:

touch ~/.bashrc
open ~/.bashrc

Następnie musisz skonfigurować klucz interfejsu API, dodając to polecenie eksportowania:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Po zapisaniu pliku zastosuj zmiany, wykonując te czynności:

source ~/.bashrc

macOS – Zsh

Zsh to częsta konfiguracja terminala w systemach Linux i macOS. Aby sprawdzić, czy masz plik konfiguracji, uruchom to polecenie:

~/.zshrc

Jeśli odpowiedź brzmi „Brak takiego pliku lub katalogu”, musisz utworzyć ten plik i otworzyć go, uruchamiając te polecenia lub używając polecenia bash:

touch ~/.zshrc
open ~/.zshrc

Następnie musisz ustawić klucz interfejsu API, dodając to polecenie eksportowania:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Po zapisaniu pliku zastosuj zmiany, wykonując te czynności:

source ~/.zshrc

Windows

  1. W ustawieniach systemu wyszukaj „Zmienne środowiskowe”.
  2. Edytuj „Zmienną użytkownika” (dla bieżącego użytkownika) lub „Zmienną systemową” (dla wszystkich użytkowników – używaj z ostrożnością).
  3. Utwórz zmienną i dodaj export GEMINI_API_KEY=your_key_here
  4. Zastosuj zmiany

Wysyłanie pierwszego żądania do interfejsu Gemini API

Aby sprawdzić konfigurację, użyj polecenia 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."}]
        }]
       }'

Zabezpieczanie klucza interfejsu API

Pamiętaj, aby chronić klucz interfejsu Gemini API. Oto kilka kwestii, o których musisz pamiętać, gdy korzystasz z klucza interfejsu Gemini API:

  • Interfejs Gemini API od Google AI używa kluczy API do autoryzacji. Jeśli inni użytkownicy uzyskają dostęp do klucza Gemini API, będą mogli wykonywać wywołania, korzystając z limitu Twojego projektu. Może to spowodować utratę limitu lub dodatkowe opłaty za opłacane projekty, a także umożliwić im dostęp do dostrojonych modeli i plików.

  • Dodanie ograniczeń klucza interfejsu API może pomóc ograniczyć obszar, w którym można używać poszczególnych kluczy API.

  • To Twoja odpowiedzialność, aby chronić klucz interfejsu Gemini API.

    • NIE sprawdzaj kluczy interfejsu Gemini API w kontroli źródłowej.
    • Aplikacje po stronie klienta (Android, Swift, internet i Dart/Flutter) mogą narazić na ryzyko ujawnienia kluczy API. Nie zalecamy używania pakietów Google AI client SDK w aplikacjach produkcyjnych do wywoływania interfejsu Google AI Gemini API bezpośrednio z aplikacji mobilnych i internetowych.

Ogólne sprawdzone metody znajdziesz też w tym artykule w Centrum pomocy.