Texto
Contar tokens de mensaje
Cuenta los tokens de entrada de una solicitud de Messages sin crear una respuesta.
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
usageen 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_idnecesita el contador propio del modelo y devolverá un503cuando no haya ninguno disponible. Envíeanthropic-beta: files-api-2025-04-14con dicha solicitud.
Solicitud
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!"}
]
}'Respuesta
{
"input_tokens": 12
}Campos importantes
Autorización
BearerAuth 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