Gemini nativo

Contar tokens

Cuenta los tokens de entrada de una solicitud de Gemini sin generar ni facturar.

POST
/v1beta/models/{model}:countTokens

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

contentsarray

Contenido de la conversación con la misma estructura que Generar contenido.

generateContentRequestobject

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
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

200 OK
{
  "totalTokens": 7
}
totalTokensinteger
Número de tokens de entrada en la solicitud.

Autorización

AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Parámetros de ruta

model*string

Nombre del modelo (ej. gemini-2.5-pro)

Parámetros de consulta

key?string

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