Uzyskiwanie klucza interfejsu API

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

Uzyskiwanie klucza interfejsu API

Weryfikacja klucza 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"

Zabezpieczanie klucza interfejsu API

Bezpieczeństwo klucza interfejsu Gemini API jest ważne. Oto kilka rzeczy, o których warto pamiętać: pamiętaj o tych kwestiach:

  • Do autoryzacji interfejs Gemini API AI od Google używa kluczy interfejsu API. Jeśli inni uzyskają dostęp do klucza interfejsu Gemini API, mogą wykonywać wywołania z wykorzystaniem limitu projektu, co może spowodować utratę limitu lub naliczenie dodatkowych opłat (jeśli rozliczenia są ). Klucze interfejsu API chronią też dostęp do dostrojonych modeli i plików.

  • Gdy w Google AI Studio klikniesz Pobierz klucz interfejsu API, możesz wybrać udostępnić klucz interfejsu Gemini API w nowym lub istniejącym projekcie Google Cloud. Lista kluczy interfejsu API w Google AI Studio pokazuje wszystkie klucze interfejsu API udostępnione przez AI Studio do użycia AI Gemini API (wraz ze wszystkimi powiązanymi projektami Google Cloud).

    • Jednak dowolne klucze interfejsu API w projekcie Google Cloud mogą być służy do wywoływania interfejsu Gemini API od Google AI. Możesz wyświetlać wszystkie swoje dane kluczy interfejsu API projektu w sekcji Interfejsy API Usługi > Panel z danymi logowania w konsoli Google Cloud.

  • Dodaję Ograniczenia klucza interfejsu API może pomóc ograniczyć powierzchnię możliwą do wykorzystania za pomocą każdego klucza interfejsu API. Domyślnie atrybut Klucza interfejsu Gemini API wygenerowanego przez Google AI Studio można używać tylko z AI od Google Gemini API (oficjalnie nazywany „Generative Language API” lub generativelanguage.googleapis.com).

    • Jeśli w projekcie Google Cloud znajdują się klucze interfejsu API, w których nie ma interfejsu API ograniczeń ani kluczy interfejsu API, które znajdują się na liście dozwolonych API, można ich używać z interfejsem Google AI Gemini API. Najlepiej, ćwiczenie ograniczania każdego klucza interfejsu API wyłącznie do wywoływanych za jego pomocą interfejsów API .
    • Pamiętaj, że nawet przy ograniczeniach dotyczących klucza interfejsu API, jeśli haker przejmie Twoją API, może go używać do wykonywania wywołań z wykorzystaniem limitu projektu dla wszystkich interfejsy API znajdujące się na liście dozwolonych dla danego klucza interfejsu API.

  • Odpowiadasz za bezpieczeństwo klucza interfejsu Gemini API.

    • NIE sprawdzaj kluczy interfejsu Gemini API w kontroli źródła.
    • Ryzyko związane z aplikacjami po stronie klienta (Android, Swift, internet oraz Dart/Flutter) ujawnianie kluczy API, dlatego nie zalecamy korzystania z pakietów SDK klienta AI od Google w aplikacjach w wersji produkcyjnej, aby wywoływać interfejs Google AI Gemini API bezpośrednio z aplikacji mobilnych i internetowych. Aby dowiedzieć się więcej, zapoznaj się z krótkimi wprowadzeniami do pakietu SDK. sprawdzonych metod zabezpieczania klucza interfejsu API w wybranych językach.

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

Dalsze kroki