Eine detaillierte Anleitung zum Zählen von Tokens mit der Gemini API, einschließlich der Zählweise von Bildern, Audio und Video, finden Sie im Leitfaden zum Zählen von Tokens und im zugehörigen Cookbook-Rezept.
Methode: models.countTokens
Führt den Tokenizer eines Modells für die Eingabe Content aus und gibt die Anzahl der Tokens zurück. Weitere Informationen zu Tokens finden Sie im Leitfaden zu Tokens.
Endpunkt
posthttps: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:countTokens
Pfadparameter
model
string
Erforderlich. Der Ressourcenname des Modells. Dient als ID für das zu verwendende Modell.
Dieser Name muss mit einem Modellnamen übereinstimmen, der von der Methode models.list zurückgegeben wird.
Format: models/{model}. Hat die Form models/{model}.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
contents[]
object (Content)
Optional. Die Eingabe, die dem Modell als Prompt gegeben wird. Dieses Feld wird ignoriert, wenn generateContentRequest festgelegt ist.
generateContentRequest
object (GenerateContentRequest)
Optional. Die Gesamteingabe für das Model. Dazu gehören der Prompt sowie andere Informationen zur Modellsteuerung wie Systemanweisungen und/oder Funktionsdeklarationen für Funktionsaufrufe. Models/Contents und generateContentRequests schließen sich gegenseitig aus. Sie können entweder Model + Contents oder eine generateContentRequest senden, aber nicht beides.
Beispielanfrage
Text
Python
Node.js
Ok
Muschel
Chat
Python
Node.js
Ok
Muschel
Inline-Medien
Python
Node.js
Ok
Muschel
Video
Python
Node.js
Ok
Muschel
Python
Cache
Python
Node.js
Ok
Systemanweisung
Ok
Tools
Java
Antworttext
Eine Antwort von models.countTokens.
Gibt die tokenCount des Modells für den prompt zurück.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
totalTokens
integer
Die Anzahl der Tokens, in die das Model den prompt tokenisiert. Immer nicht negativ.
cachedContentTokenCount
integer
Anzahl der Tokens im im Cache gespeicherten Teil des Prompts (im Cache gespeicherter Inhalt).
promptTokensDetails[]
object (ModalityTokenCount)
Nur Ausgabe. Liste der Modalitäten, die in der Anfrageneingabe verarbeitet wurden.
cacheTokensDetails[]
object (ModalityTokenCount)
Nur Ausgabe. Liste der Modalitäten, die im im Cache gespeicherten Inhalt verarbeitet wurden.
| JSON-Darstellung |
|---|
{ "totalTokens": integer, "cachedContentTokenCount": integer, "promptTokensDetails": [ { object ( |