Para obtener una guía detallada sobre cómo contar tokens con la API de Gemini, incluida la forma en que se cuentan las imágenes, el audio y el video, consulta la Guía de recuento de tokens y la receta del libro de recetas que la acompaña.
Método: models.countTokens
- Extremo
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Ejemplo de solicitud
- GenerateContentRequest
Ejecuta el analizador de un modelo en la entrada Content
y muestra el recuento de tokens. Consulta la guía de tokens para obtener más información.
Extremo
publicaciónhttps: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:countTokens
Parámetros de ruta
model
string
Obligatorio. Es el nombre del recurso del modelo. Este ID sirve como ID para que lo use el modelo.
Este nombre debe coincidir con un nombre de modelo que devuelva el método models.list
.
Formato: models/{model}
Tiene el formato models/{model}
.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
contents[]
object (Content
)
Opcional. La entrada que se le proporciona al modelo como una instrucción. Este campo se ignora cuando se establece generateContentRequest
.
generateContentRequest
object (GenerateContentRequest
)
Opcional. Es la entrada general que se le proporciona a Model
. Esto incluye la instrucción, así como otra información de dirección del modelo, como las instrucciones del sistema o las declaraciones de funciones para llamar a funciones. Los Model
, Content
y generateContentRequest
son mutuamente excluyentes. Puedes enviar Model
+ Content
o generateContentRequest
, pero nunca ambos.
Ejemplo de solicitud
Texto
Python
Node.js
Go
Una caracola
Kotlin
Swift
Dart
Java
Chat
Python
Node.js
Go
Una caracola
Kotlin
Swift
Dart
Java
Contenido multimedia intercalado
Python
Node.js
Go
Una caracola
Kotlin
Swift
Dart
Java
Video
Python
Node.js
Go
Una caracola
Python
Caché
Python
Node.js
Go
Instrucción del sistema
Python
Node.js
Go
Kotlin
Swift
Dart
Java
Herramientas
Python
Node.js
Kotlin
Swift
Dart
Java
Cuerpo de la respuesta
Una respuesta de models.countTokens
.
Muestra el tokenCount
del modelo para el 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 Model
segmenta prompt
. Siempre es un número no negativo.
cachedContentTokenCount
integer
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.
Representación JSON |
---|
{
"totalTokens": integer,
"cachedContentTokenCount": integer,
"promptTokensDetails": [
{
object ( |
GenerateContentRequest
Solicita generar una finalización a partir del modelo.
model
string
Obligatorio. Es el nombre del Model
que se usará para generar la finalización.
Formato: models/{model}
.
contents[]
object (Content
)
Obligatorio. El contenido de la conversación actual con el modelo.
Para consultas de un solo turno, esta es una instancia única. Para las consultas de varios turnos, como chat, este es un campo repetido que contiene el historial de conversaciones y la solicitud más reciente.
tools[]
object (Tool
)
Opcional. Es una lista de Tools
que Model
puede usar para generar la siguiente respuesta.
Un Tool
es un fragmento de código que permite que el sistema interactúe con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y del alcance del Model
. Los Tool
admitidos son Function
y codeExecution
. Consulta las guías Llamadas a función y Ejecución de código para obtener más información.
toolConfig
object (ToolConfig
)
Opcional. Configuración de la herramienta para cualquier Tool
especificado en la solicitud. Consulta la Guía de llamadas a funciones para ver un ejemplo de uso.
safetySettings[]
object (SafetySetting
)
Opcional. Es una lista de instancias SafetySetting
únicas para bloquear contenido no seguro.
Esto se aplicará en GenerateContentRequest.contents
y GenerateContentResponse.candidates
. No debe haber más de un parámetro de configuración para cada tipo de SafetyCategory
. La API bloqueará todo el contenido y las respuestas que no cumplan con los umbrales establecidos por esta configuración. Esta lista anula la configuración predeterminada de cada SafetyCategory
especificada en safetySettings. Si no hay un SafetySetting
para un SafetyCategory
determinado proporcionado en la lista, la API usará la configuración de seguridad predeterminada para esa categoría. Se admiten las categorías de daño HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT y HARM_CATEGORY_CIVIC_INTEGRITY. Consulta la guía para obtener información detallada sobre la configuración de seguridad disponible. Consulta también la guía de seguridad para aprender a incorporar consideraciones de seguridad en tus aplicaciones de IA.
systemInstruction
object (Content
)
Opcional. El desarrollador estableció instrucciones del sistema. Actualmente, solo se admite texto.
generationConfig
object (GenerationConfig
)
Opcional. Opciones de configuración para la generación y los resultados de los modelos.
cachedContent
string
Opcional. Es el nombre del contenido almacenado en caché que se usará como contexto para entregar la predicción. Formato: cachedContents/{cachedContent}
Representación JSON |
---|
{ "model": string, "contents": [ { object ( |