Si deseas obtener una guía detallada para contar tokens con la API de Gemini, incluido cómo se cuentan las imágenes, el audio y el video, consulta la guía para contar tokens y la receta del libro de cocina que la acompaña.
Método: models.countTokens
- Extremo
- Parámetros de ruta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Ejemplo de solicitud
Ejecuta el tokenizador de un modelo en la Content de entrada y muestra el recuento de tokens. Consulta la guía de tokens para obtener más información sobre los tokens.
Extremo
posthttps: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:countTokens
Parámetros de ruta
model
string
Obligatorio. El nombre del recurso del modelo. Esto sirve como un ID para que lo use el modelo.
Este nombre debe coincidir con un nombre de modelo que muestre el método models.list.
Formato: models/{model} Toma la forma models/{model}.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
contents[]
object (Content)
Es opcional. La entrada que se le da al modelo como una instrucción. Este campo se ignora cuando se establece generateContentRequest.
generateContentRequest
object (GenerateContentRequest)
Es opcional. La entrada general que se le da al Model. Esto incluye la instrucción, así como otra información de dirección del modelo, como instrucciones del sistema o declaraciones de funciones para la llamada a funciones. Los Models/Contents y los generateContentRequests son mutuamente excluyentes. Puedes enviar Model + Contents o un generateContentRequest, pero nunca ambos.
Ejemplo de solicitud
Texto
Python
Node.js
Go
Almeja
Chat
Python
Node.js
Go
Almeja
Contenido multimedia intercalado
Python
Node.js
Go
Almeja
Video
Python
Node.js
Go
Almeja
Python
Caché
Python
Node.js
Go
Instrucción del sistema
Go
Herramientas
Java
Cuerpo de la respuesta
Una respuesta de models.countTokens.
Muestra el tokenCount del modelo para la prompt.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
totalTokens
integer
Es la cantidad de tokens en los que el Model tokeniza la prompt. Siempre es un valor no negativo.
cachedContentTokenCount
integer
Es la cantidad de tokens en la parte almacenada en caché de la instrucción (el contenido almacenado en caché).
promptTokensDetails[]
object (ModalityTokenCount)
Solo salida. Es la lista de modalidades que se procesaron en la entrada de la solicitud.
cacheTokensDetails[]
object (ModalityTokenCount)
Solo salida. Es la lista de modalidades que se procesaron en el contenido almacenado en caché.
| Representación JSON |
|---|
{ "totalTokens": integer, "cachedContentTokenCount": integer, "promptTokensDetails": [ { object ( |