Uzyskiwanie klucza interfejsu API

Aby używać interfejsu Gemini API, potrzebujesz klucza interfejsu API. Możesz utworzyć klucz jednym kliknięciem w Google AI Studio.

Uzyskiwanie klucza interfejsu API

Zweryfikuj klucz interfejsu API za pomocą polecenia curl

Aby sprawdzić konfigurację, możesz użyć polecenia curl. Klucz interfejsu API możesz przekazać w adresie 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}"

Lub w nagłówku 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"

Zabezpiecz swój klucz interfejsu API

Klucz interfejsu Gemini API musi być bezpieczny. Oto kilka kwestii, o których należy pamiętać, używając klucza interfejsu Gemini API:

  • Interfejs Google AI Gemini API do autoryzacji używa kluczy interfejsu API. Jeśli inne osoby uzyskają dostęp do Twojego klucza interfejsu Gemini API, będą mogły wykonywać wywołania, korzystając z limitu projektu, co może spowodować utratę limitu lub dodatkowe opłaty (jeśli płatności są włączone). Klucze interfejsu API chronią też dostęp do dostrojonych modeli i plików.

  • Gdy klikniesz Pobierz klucz interfejsu API w Google AI Studio, wybierzesz, czy chcesz udostępnić klucz interfejsu Gemini API w nowym czy istniejącym projekcie Google Cloud. Lista kluczy interfejsów API w Google AI Studio zawiera wszystkie klucze interfejsu API udostępnione przez AI Studio do użycia z interfejsem Google AI Gemini API (wraz ze wszystkimi powiązanymi projektami Google Cloud).

    • Jednak dowolne klucze interfejsu API w projekcie Google Cloud mogą zostać użyte do wywołania interfejsu Google AI Gemini API. W konsoli Google Cloud możesz przeglądać wszystkie klucze interfejsu API swojego projektu i zarządzać nimi w panelu Interfejsy API i usługi > Dane logowania.

  • Dodanie ograniczeń dotyczących kluczy interfejsu API pomaga ograniczyć obszar wykorzystywanych przez poszczególne klucze interfejsu API. Domyślnie klucza interfejsu API Gemini wygenerowanego przez Google AI Studio można używać tylko razem z interfejsem Google AI AI Gemini API (oficjalnie nazywanym „Generative Language API” lub generativelanguage.googleapis.com).

    • Jeśli w Twoim projekcie Google Cloud są klucze interfejsu API, które nie mają ograniczeń interfejsu API ani żadnych kluczy, które zostały dodane do listy dozwolonych interfejsu API języka generatywnego, możesz ich używać z interfejsem Google AI Gemini API. Sprawdzoną metodą jest ograniczenie każdego klucza API tylko do tych, które są wywoływane za jego pomocą.
    • Pamiętaj, że nawet w przypadku ograniczeń klucza interfejsu API, jeśli złośliwy użytkownik zdobędzie klucz interfejsu API, może go używać do wykonywania wywołań z wykorzystaniem limitu projektu dla wszystkich interfejsów API dodanych do listy dozwolonych dla danego klucza interfejsu API.

  • Odpowiadasz za bezpieczeństwo klucza interfejsu Gemini API.

    • NIE sprawdzaj kluczy interfejsu Gemini API pod kątem kontroli źródła.
    • Aplikacje po stronie klienta (Android, Swift, web i Dart/Flutter) ryzykują ujawnienie kluczy interfejsu API, dlatego nie zalecamy używania pakietów SDK klienta AI od Google w aplikacjach produkcyjnych do wywoływania interfejsu Google AI Gemini API bezpośrednio z aplikacji mobilnych i internetowych. Zapoznaj się z krótkimi wprowadzeniami do pakietu SDK, aby poznać sprawdzone metody zabezpieczania klucza interfejsu API w danym języku.

Ogólne sprawdzone metody znajdziesz w tym artykule pomocy.

Dalsze kroki