Pour obtenir un guide détaillé sur le décompte des jetons à l'aide de l'API Gemini, y compris sur la façon dont les images, l'audio et la vidéo sont comptabilisés, consultez le guide sur le décompte des jetons et la recette de Cookbook associée.
Méthode : models.countTokens
- Point de terminaison
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Niveaux d'accès des autorisations
- Exemple de requête
Exécute le tokenizer d'un modèle sur l'entrée Content et renvoie le nombre de jetons. Pour en savoir plus sur les jetons, consultez le guide sur les jetons.
Point de terminaison
posthttps: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:countTokens
Paramètres de chemin d'accès
model
string
Obligatoire. Nom de ressource du modèle. Il sert d'ID pour le modèle à utiliser.
Ce nom doit correspondre à un nom de modèle renvoyé par la méthode models.list.
Format : models/{model}. Il prend la forme models/{model}.
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
contents[]
object (Content)
Facultatif. Entrée fournie au modèle en tant que prompt. Ce champ est ignoré lorsque generateContentRequest est défini.
generateContentRequest
object (GenerateContentRequest)
Facultatif. Entrée globale fournie au Model. Cela inclut le prompt, ainsi que d'autres informations de pilotage du modèle, telles que les instructions système et/ou les déclarations de fonction pour l'appel de fonction. Les Models/Contents et les generateContentRequests s'excluent mutuellement. Vous pouvez envoyer des Model + Contents ou une generateContentRequest, mais jamais les deux.
Exemple de requête
Texte
Python
Node.js
Go
Shell
Chat
Python
Node.js
Go
Shell
Contenu multimédia intégré
Python
Node.js
Go
Shell
Vidéo
Python
Node.js
Go
Shell
Python
Cache
Python
Node.js
Go
Instruction système
Go
Outils
Java
Corps de la réponse
Réponse de models.countTokens.
Elle renvoie le tokenCount du modèle pour le prompt.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
totalTokens
integer
Nombre de jetons dans lesquels le Model tokenise le prompt. Toujours non négatif.
cachedContentTokenCount
integer
Nombre de jetons dans la partie mise en cache du prompt (contenu mis en cache).
promptTokensDetails[]
object (ModalityTokenCount)
Uniquement en sortie. Liste des modalités traitées dans l'entrée de la requête.
cacheTokensDetails[]
object (ModalityTokenCount)
Uniquement en sortie. Liste des modalités traitées dans le contenu mis en cache.
| Représentation JSON |
|---|
{ "totalTokens": integer, "cachedContentTokenCount": integer, "promptTokensDetails": [ { object ( |