Per una guida dettagliata sul conteggio dei token utilizzando l'API Gemini, incluso il conteggio di immagini, audio e video, consulta la guida al conteggio dei token e la ricetta del Cookbook di accompagnamento.
Metodo: models.countTokens
- Endpoint
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Esempio di richiesta
Esegue il tokenizer di un modello sull'input Content e restituisce il conteggio dei token. Per saperne di più sui token, consulta la guida ai token.
Endpoint
posthttps: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:countTokens
Parametri del percorso
model
string
Obbligatorio. Il nome della risorsa del modello. Questo funge da ID per il modello da utilizzare.
Questo nome deve corrispondere a un nome del modello restituito dal metodo models.list.
Formato: models/{model}. Assume il formato models/{model}.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
contents[]
object (Content)
Facoltativo. L'input fornito al modello come prompt. Questo campo viene ignorato quando è impostato generateContentRequest.
generateContentRequest
object (GenerateContentRequest)
Facoltativo. L'input complessivo fornito al Model. Include il prompt e altre informazioni di guida del modello, come le istruzioni di sistema e/o le dichiarazioni di funzioni per le chiamate di funzioni. Models/Contents e generateContentRequests si escludono a vicenda. Puoi inviare Model + Contents o un generateContentRequest, ma mai entrambi.
Esempio di richiesta
Testo
Python
Node.js
Vai
Conchiglia
Chat
Python
Node.js
Vai
Conchiglia
Contenuti multimediali in linea
Python
Node.js
Vai
Conchiglia
Video
Python
Node.js
Vai
Conchiglia
Python
Cache
Python
Node.js
Vai
Istruzione di sistema
Vai
Strumenti
Java
Corpo della risposta
Una risposta da models.countTokens.
Restituisce il tokenCount del modello per il prompt.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
totalTokens
integer
Il numero di token in cui il Model tokenizza il prompt. Sempre non negativo.
cachedContentTokenCount
integer
Numero di token nella parte memorizzata nella cache del prompt (i contenuti memorizzati nella cache).
promptTokensDetails[]
object (ModalityTokenCount)
Solo output. Elenco delle modalità elaborate nell'input della richiesta.
cacheTokensDetails[]
object (ModalityTokenCount)
Solo output. Elenco delle modalità elaborate nei contenuti memorizzati nella cache.
| Rappresentazione JSON |
|---|
{ "totalTokens": integer, "cachedContentTokenCount": integer, "promptTokensDetails": [ { object ( |