Texto

Contar Tokens de Mensagem

Conta os tokens de entrada de uma solicitação de Mensagens sem criar uma resposta.

POST
/v1/messages/count_tokens

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 usage em 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_id precisa do contador do próprio modelo e retorna 503 quando nenhum está disponível. Envie anthropic-beta: files-api-2025-04-14 com tal solicitação.

Exemplo

Requisição

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!"}
    ]
  }'

Exemplo de resposta

Resposta

200 OK
{
  "input_tokens": 12
}

Campos importantes

input_tokensinteger
Número estimado de tokens de entrada na solicitação.

Autorização

BearerAuth
AuthorizationBearer <token>

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