Gemini nativo
Contar tokens
Cuenta los tokens de entrada de una solicitud de Gemini sin generar ni facturar.
Cuenta los tokens de entrada de una solicitud de Gemini antes de enviarla. La llamada no se factura y no requiere saldo en la cuenta, pero sí necesita una API key. Utilícelo con un modelo cuya respuesta de Obtener modelo liste countTokens en supportedGenerationMethods.
Envíe contents o un generateContentRequest completo. Utilice el conteo para la planificación; el cobro de una solicitud de generación proviene de usageMetadata en esa respuesta.
Autenticación
Igual que Generar contenido: ?key=, x-goog-api-key o Authorization: Bearer.
Cuerpo de la solicitud
Contenido de la conversación con la misma estructura que Generar contenido.
Una solicitud de generación completa de Gemini para contar, como alternativa a contents. También se acepta generate_content_request.
Errores
400 INVALID_ARGUMENT: el cuerpo no es válido o el modelo no acepta solicitudes de Gemini.401 UNAUTHENTICATED: la API key falta o no es válida.503 UNAVAILABLE: no hay ninguna ruta disponible para el modelo en este momento. Inténtelo de nuevo más tarde.
Solicitud
curl -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:countTokens" \
-H "x-goog-api-key: sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"parts": [{"text": "Hello, Gemini!"}]
}
]
}'Respuesta
{
"totalTokens": 7
}Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de ruta
Nombre del modelo (ej. gemini-2.5-pro)
Parámetros de consulta
Clave de API (alternativa a la autenticación por encabezado)
Cuerpo de la solicitud
application/json
Respuesta
application/json
application/json
application/json
application/json