Texto

Contar tokens de mensaje

Cuenta los tokens de entrada de una solicitud de Messages sin crear una respuesta.

POST
/v1/messages/count_tokens

Descripción general

Envíe los mismos campos model, messages, system, tools y thinking que en Crear mensaje, sin max_tokens, para contar los tokens de entrada antes de enviar la solicitud. El modelo debe listar anthropic_messages en accepted_request_formats.

Notas

  • El conteo de tokens requiere una API key y no tiene costo.
  • El conteo es para fines de planificación. El cargo por la solicitud real proviene del usage en su respuesta.
  • TokenLab prefiere un conteo realizado por el propio contador del modelo. Cuando dicho contador no está disponible, TokenLab devuelve una estimación local y establece el encabezado de respuesta X-TokenLab-Count-Tokens-Source: local_estimate.
  • Los errores de autenticación, permisos y entrada seguirán fallando. Una solicitud que haga referencia a un file_id necesita el contador propio del modelo y devolverá un 503 cuando no haya ninguno disponible. Envíe anthropic-beta: files-api-2025-04-14 con dicha solicitud.

Ejemplo

Solicitud

cURL
curl -X POST "https://api.tokenlab.sh/v1/messages/count_tokens" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

Ejemplo de respuesta

Respuesta

200 OK
{
  "input_tokens": 12
}

Campos importantes

input_tokensinteger
Número estimado de tokens de entrada en la solicitud.

Autorización

BearerAuth
AuthorizationBearer <token>

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

Ubicación: header

Cuerpo de la solicitud

application/json

Respuesta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json