Dokumentacja Gemini API

Ten dokument zawiera informacje o interfejsach API typu unary, streaming i real-time, których możesz używać do interakcji z modelami Gemini. Interfejsów API REST możesz używać w dowolnym środowisku obsługującym żądania HTTP. Informacje o tym, jak rozpocząć korzystanie z pierwszego wywołania interfejsu API, znajdziesz w przewodniku dla początkujących. Jeśli szukasz informacji o bibliotekach i pakietach SDK dla konkretnych języków, kliknij link do danego języka w menu po lewej stronie w sekcji Dokumentacja pakietu SDK.

Podstawowe punkty końcowe

Interfejs Gemini API jest zorganizowany wokół tych głównych punktów końcowych:

• Interakcje (CreateInteraction) (zalecane): zalecany standardowy element podstawowy do tworzenia aplikacji z Gemini, zoptymalizowany pod kątem przepływów pracy agenta, zarządzania stanem po stronie serwera oraz złożonych rozmów wielomodowych, wieloetapowych.
• Standardowe generowanie treści (generateContent): standardowy punkt końcowy REST, który przetwarza Twoje żądanie i zwraca pełną odpowiedź modelu w jednym pakiecie. Najlepiej sprawdza się w przypadku zadań nieinteraktywnych, w których możesz poczekać na cały wynik.
• Strumieniowe generowanie treści (streamGenerateContent): używa zdarzeń wysyłanych przez serwer (SSE), aby przesyłać do Ciebie fragmenty odpowiedzi w miarę ich generowania. Zapewnia to szybsze i bardziej interaktywne działanie aplikacji, takich jak chatboty.
• Interfejs Live API (BidiGenerateContent): interfejs API oparty na protokole WebSocket, który utrzymuje stan i umożliwia strumieniowanie dwukierunkowe. Jest przeznaczony do zastosowań konwersacyjnych w czasie rzeczywistym.
• Tryb wsadowy (batchGenerateContent): standardowy punkt końcowy REST do przesyłania partii żądań generateContent.
• Osadzanie (embedContent): standardowy punkt końcowy REST który generuje wektor dystrybucyjny tekstu na podstawie danych wejściowych Content.
• Interfejsy Gen Media API: punkty końcowe do generowania multimediów za pomocą naszych specjalistycznych modeli, takich jak Imagen do generowania obrazów, i Veo do generowania filmów. Gemini ma też wbudowane te funkcje, do których możesz uzyskać dostęp za pomocą interfejsu generateContent API.
• Interfejsy Platform API: punkty końcowe narzędziowe, które obsługują podstawowe funkcje, takie jak przesyłanie plików i zliczanie tokenów.

Uwierzytelnianie

Wszystkie żądania wysyłane do interfejsu Gemini API muszą zawierać nagłówek x-goog-api-key z Twoim kluczem interfejsu API. Możesz go utworzyć kilkoma kliknięciami w Google AI Studio.

Oto przykład żądania z kluczem interfejsu API zawartym w nagłówku:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Instrukcje dotyczące przekazywania klucza do interfejsu API za pomocą pakietów SDK Gemini, znajdziesz w przewodniku Korzystanie z kluczy interfejsu Gemini API.