Szczegółowy przewodnik po zliczaniu tokenów za pomocą interfejsu Gemini API, w tym informacje o tym, jak zliczane są obrazy, dźwięk i filmy, znajdziesz w przewodniku po zliczaniu tokenów i powiązanym przepisie.
Metoda: models.countTokens
Uruchamia tokenizator modelu na danych wejściowych Content i zwraca liczbę tokenów. Więcej informacji o tokenach znajdziesz w przewodniku po tokenach.
Punkt końcowy
posthttps: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:countTokens
Parametry ścieżki
model
string
Wymagane. Nazwa zasobu modelu. Służy on jako identyfikator modelu.
Ta nazwa powinna być zgodna z nazwą modelu zwróconą przez metodę models.list.
Format: models/{model} Ma on postać models/{model}.
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
contents[]
object (Content)
Opcjonalnie: Dane wejściowe przekazywane do modelu w formie promptu. To pole jest ignorowane, gdy ustawiona jest wartość generateContentRequest.
generateContentRequest
object (GenerateContentRequest)
Opcjonalnie: Ogólne dane wejściowe przekazane do Model. Obejmuje to prompt oraz inne informacje sterujące modelem, takie jak instrukcje systemowe lub deklaracje funkcji dla wywoływania funkcji. Models/Contents i generateContentRequests wykluczają się wzajemnie. Możesz wysłać Model + Content lub generateContentRequest, ale nigdy obu tych rzeczy.
Przykładowe żądanie
Tekst
Python
Node.js
Przeczytaj
Muszla
Czat
Python
Node.js
Przeczytaj
Muszla
Media wbudowane
Python
Node.js
Przeczytaj
Muszla
Wideo
Python
Node.js
Przeczytaj
Muszla
Python
Cache (Pamięć podręczna)
Python
Node.js
Przeczytaj
Instrukcja systemowa
Przeczytaj
Narzędzia
Java
Treść odpowiedzi
Odpowiedź od models.countTokens.
Zwraca tokenCount modelu dla prompt.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
totalTokens
integer
Liczba tokenów, na które Model dzieli prompt. Zawsze nieujemna.
cachedContentTokenCount
integer
Liczba tokenów w części promptu zapisanej w pamięci podręcznej (treści w pamięci podręcznej).
promptTokensDetails[]
object (ModalityTokenCount)
Tylko dane wyjściowe. Lista rodzajów danych, które zostały przetworzone w danych wejściowych żądania.
cacheTokensDetails[]
object (ModalityTokenCount)
Tylko dane wyjściowe. Lista rodzajów danych, które zostały przetworzone w zawartości z pamięci podręcznej.
| Zapis JSON |
|---|
{ "totalTokens": integer, "cachedContentTokenCount": integer, "promptTokensDetails": [ { object ( |