Skip to main content
Google Gemini to bardzo potężny system AI do rozmów, który potrafi w ciągu kilku sekund wygenerować płynne i naturalne odpowiedzi na wprowadzone zapytania. Gemini oferuje zdumiewającą inteligentną pomoc, znacznie zwiększając wydajność i kreatywność ludzi. Dokument ten głównie opisuje proces korzystania z Gemini Chat Completion API, dzięki któremu możemy łatwo korzystać z oficjalnych funkcji rozmowy Gemini.

Proces aplikacji

Aby korzystać z Gemini Chat Completion API, najpierw można przejść na stronę Gemini Chat Completion API i kliknąć przycisk „Acquire”, aby uzyskać potrzebne poświadczenia: Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zalogowaniu lub rejestracji automatycznie wrócisz na bieżącą stronę. Podczas pierwszej aplikacji otrzymasz darmowy limit, który pozwala na bezpłatne korzystanie z tego API.

Podstawowe użycie

Następnie możesz wypełnić odpowiednie treści na interfejsie, jak pokazano na obrazku:

Podczas pierwszego użycia tego interfejsu musimy wypełnić przynajmniej trzy pola: jedno to authorization, które można wybrać bezpośrednio z rozwijanej listy. Kolejny parametr to model, model to kategoria modelu, którą wybieramy z oficjalnej strony Gemini, mamy tutaj głównie 6 rodzajów modeli, szczegóły można zobaczyć w dostarczonych modelach. Ostatni parametr to messages, messages to tablica naszych zapytań, jest to tablica, która pozwala na jednoczesne przesyłanie wielu zapytań, każde zapytanie zawiera role i content, gdzie role oznacza rolę pytającego, oferujemy trzy tożsamości: user, assistant, system. Drugie content to konkretna treść naszego zapytania. Możesz również zauważyć, że po prawej stronie znajduje się odpowiedni kod do wywołania, który możesz skopiować i uruchomić, lub możesz bezpośrednio kliknąć przycisk „Try”, aby przetestować.

Po wywołaniu zauważamy, że zwrócony wynik wygląda następująco:
Zwrócony wynik zawiera wiele pól, które są opisane poniżej:
  • id, identyfikator generowanego zadania rozmowy, używany do unikalnego oznaczania tego zadania rozmowy.
  • model, wybrany model z oficjalnej strony Gemini.
  • choices, informacje o odpowiedziach udzielonych przez Gemini na zapytania.
  • usage: statystyki dotyczące tokenów dla tej sesji pytania i odpowiedzi.
W tym przypadku choices zawiera informacje o odpowiedziach Gemini, a w nim choices to konkretne informacje o odpowiedzi Gemini, co można zobaczyć na obrazku.

Można zauważyć, że pole content w choices zawiera konkretną treść odpowiedzi Gemini.

Odpowiedzi strumieniowe

Ten interfejs obsługuje również odpowiedzi strumieniowe, co jest bardzo przydatne w integracji z stronami internetowymi, umożliwiając wyświetlanie efektu literowego. Aby uzyskać odpowiedzi strumieniowe, można zmienić parametr stream w nagłówku żądania na true. Zmiana jak na obrazku, jednak kod wywołania musi być odpowiednio zmieniony, aby obsługiwał odpowiedzi strumieniowe.

Po zmianie stream na true, API zwróci odpowiednie dane JSON w wierszach, a na poziomie kodu musimy wprowadzić odpowiednie zmiany, aby uzyskać wyniki w wierszach. Przykładowy kod wywołania w Pythonie:
Efekt wyjściowy wygląda następująco:
Można zauważyć, że odpowiedzi zawierają wiele data, a data wewnątrz choices to najnowsza treść odpowiedzi, zgodna z wcześniej przedstawioną treścią. choices to nowa treść odpowiedzi, którą można zintegrować z systemem. Zakończenie strumieniowej odpowiedzi jest określane na podstawie zawartości data; jeśli zawartość to [DONE], oznacza to, że strumieniowa odpowiedź została zakończona. Zwracane wyniki data mają wiele pól, które są opisane poniżej:
  • id, identyfikator generacji zadania rozmowy, używany do unikalnej identyfikacji tego zadania.
  • model, wybrany model Gemini.
  • choices, informacje o odpowiedzi Gemini na zapytanie.
JavaScript również jest wspierany, na przykład kod do strumieniowego wywołania w Node.js wygląda następująco:
Przykładowy kod w Javie:
Inne języki można dostosować samodzielnie, zasada jest taka sama.

Wieloetapowa rozmowa

Jeśli chcesz zintegrować funkcję wieloetapowej rozmowy, musisz przesłać wiele zapytań w polu messages, przykłady wielu zapytań są pokazane na poniższym obrazku:

Przykładowy kod wywołania w Pythonie:
Przesyłając wiele zapytań, można łatwo zrealizować wieloetapową rozmowę, uzyskując następujące odpowiedzi:
Można zauważyć, że choices zawiera informacje zgodne z podstawowym użyciem, co obejmuje konkretne treści odpowiedzi Gemini na wiele rozmów, co pozwala na odpowiadanie na odpowiednie pytania w oparciu o wiele treści rozmów.

Model wielomodalny Gemini-3.0

Przykład żądania:
Przykład wyniku:
Oczywiście możesz również przesłać link do wideo, konkretne wejście wygląda następująco:
Przykład wyniku:
Z powyższego można wywnioskować, że model Gemini 3.0 może wspierać zrozumienie multimodalne.

Model multimodalny Gemini-3.1

Gemini 3.1 Pro jest ulepszoną wersją Gemini 3.0 Pro, a jego podstawowy model to gemini-3.1-pro-preview, który również obsługuje tekst, obrazy, wideo i inne multimodalne wejścia, posiadając silniejsze zdolności wnioskowania i rozumienia. Sposób użycia jest całkowicie zgodny z Gemini 3.0 Pro, wystarczy zamienić parametr model na gemini-3.1-pro. Przykład żądania:
Gemini 3.1 Pro również wspiera zrozumienie wideo:
Format odpowiedzi jest zgodny z Gemini 3.0 Pro, szczegóły można znaleźć w powyższej sekcji dotyczącej modelu multimodalnego Gemini-3.0.

Obsługa błędów

Podczas wywoływania API, jeśli wystąpi błąd, API zwróci odpowiedni kod błędu i informacje. Na przykład:
  • 400 token_mismatched: Zły wniosek, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 400 api_not_implemented: Zły wniosek, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 401 invalid_token: Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacyjny.
  • 429 too_many_requests: Zbyt wiele żądań, przekroczono limit szybkości.
  • 500 api_error: Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

Przykład odpowiedzi błędu

Wnioski

Dzięki temu dokumentowi zrozumieliście, jak łatwo korzystać z Gemini Chat Completion API, aby wdrożyć funkcje rozmowy oficjalnego Gemini. Mamy nadzieję, że ten dokument pomoże Wam lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań, prosimy o kontakt z naszym zespołem wsparcia technicznego.