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
- Przeczytaj krótkie wprowadzenia do interfejsu API, aby poznać sprawdzone metody zabezpieczania klucza interfejsu API i jego używania.