Texto
Contar Tokens de Mensagem
Conta os tokens de entrada de uma solicitação de Mensagens sem criar uma resposta.
Visão geral
Envie os mesmos campos model, messages, system, tools e thinking que em Criar Mensagem, sem o max_tokens, para contar os tokens de entrada antes de enviar a solicitação. O modelo deve listar anthropic_messages em accepted_request_formats.
Notas
- A contagem de tokens requer uma chave de API e não é cobrada.
- A contagem serve para planejamento. A cobrança pela solicitação real vem do
usageem sua resposta. - O TokenLab prefere uma contagem feita pelo próprio contador do modelo. Quando esse contador não está disponível, o TokenLab retorna uma estimativa local e define o cabeçalho de resposta
X-TokenLab-Count-Tokens-Source: local_estimate. - Erros de autenticação, permissão e entrada ainda resultarão em falha. Uma solicitação que referencia um
file_idprecisa do contador do próprio modelo e retorna503quando nenhum está disponível. Envieanthropic-beta: files-api-2025-04-14com tal solicitação.
Requisição
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!"}
]
}'Resposta
{
"input_tokens": 12
}Campos importantes
Autorização
BearerAuth Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Corpo da requisição
application/json
Resposta
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json