- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- GenerateContentRequest
Ejecuta el tokenizador de un modelo en el contenido de entrada y muestra el recuento de tokens.
Solicitud HTTP
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:countTokens
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
model |
Obligatorio. El nombre del recurso del modelo. Esto sirve como un ID para que use el modelo. Este nombre debe coincidir con el nombre de modelo que muestra el método Formato: |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "contents": [ { object ( |
Campos | |
---|---|
contents[] |
Opcional. La entrada proporcionada al modelo como instrucción. Este campo se ignora cuando se configura |
generateContentRequest |
Opcional. La entrada general otorgada al modelo. models.countTokens contará los mensajes, las llamadas a funciones, etcétera. |
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:
Representación JSON |
---|
{ "totalTokens": integer } |
Campos | |
---|---|
totalTokens |
La cantidad de tokens en los que Siempre no es negativo. Cuando se configura cacheContent, este sigue siendo el tamaño total de la instrucción efectiva. Es decir, esto incluye la cantidad de tokens en el contenido almacenado en caché. |
Permisos de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/generative-language
https://www.googleapis.com/auth/generative-language.tuning
https://www.googleapis.com/auth/generative-language.tuning.readonly
https://www.googleapis.com/auth/generative-language.retriever
https://www.googleapis.com/auth/generative-language.retriever.readonly
Para obtener más información, consulta Descripción general de la autenticación.
GenerateContentRequest
Solicitud para generar una finalización a partir del modelo.
Representación JSON |
---|
{ "model": string, "contents": [ { object ( |
Campos | |
---|---|
model |
Obligatorio. Es el nombre de Formato: |
contents[] |
Obligatorio. El contenido de la conversación actual con el modelo. Para consultas de un solo turno, esta es una instancia única. Para consultas de varios turnos, es un campo repetido que contiene el historial de conversaciones y la solicitud más reciente. |
tools[] |
Opcional. Una lista de Un |
toolConfig |
Opcional. Configuración de herramientas para cualquier |
safetySettings[] |
Opcional. Una lista de instancias de Esto se aplicará de manera forzosa en |
systemInstruction |
Opcional. Instrucción del sistema establecida por el desarrollador. Actualmente, es solo texto. |
generationConfig |
Opcional. Opciones de configuración para la generación y la salida de modelos. |
cachedContent |
Opcional. Es el nombre del contenido almacenado en caché que se usa como contexto para entregar la predicción. Nota: Solo se usa en el almacenamiento en caché explícito, donde los usuarios pueden tener control sobre el almacenamiento en caché (p.ej., qué contenido almacenar en caché) y disfrutar de ahorros de costos garantizados. Formato: |