Solicitação e uso da API Claude Messages Count Tokens

A API Claude Messages Count Tokens pode calcular a quantidade de Tokens de entrada de uma Message sem realmente criar mensagens, incluindo a contagem de Tokens de conteúdos como ferramentas, imagens e documentos. Isso é muito útil quando é necessário estimar custos ou verificar se a entrada excede o limite de contexto do modelo. Este documento apresenta principalmente o fluxo de uso da API Claude Messages Count Tokens.

Processo de solicitação

Para usar a API Claude Messages Count Tokens, primeiro acesse o Console Ace Data Cloud para obter seu API Token e guarde-o para uso posterior.

Se você ainda não tiver feito login ou se registrado, será automaticamente redirecionado para a página de login, onde será convidado a se registrar e fazer login; após a conclusão, você retornará automaticamente à página atual. Um único API Token pode chamar todos os serviços da plataforma, sem necessidade de solicitar um para cada serviço separadamente. A primeira solicitação oferece créditos gratuitos para uma experiência sem custo; quando os créditos forem insuficientes, você poderá recarregar o saldo geral no console.

📘 Documentação completa: Claude Messages Count Tokens API →

Uso básico

O caminho de solicitação da API Claude Messages Count Tokens é /v1/messages/count_tokens, mantendo-se consistente com a API oficial da Anthropic. Precisamos fornecer pelo menos dois parâmetros obrigatórios:

model: seleciona o modelo Claude a ser usado; claude-opus-5-5 pode ser usado para Messages Token Count, assim como o mais recente carro-chefe claude-fable-5-1; o antigo claude-fable-5 permanece compatível e preservado. claude-sonnet-5-5 foi adicionado à interface nativa da série Messages, com suporte para entrada de imagens e pensamento adaptativo; seus preços de referência oficiais para entrada, saída e leitura de cache são, respectivamente, 2, 10 e 0,20 dólares por milhão de Tokens.
messages: o array de mensagens de entrada, em que cada mensagem contém role (função) e content (conteúdo).

Parâmetros opcionais comuns:

system: prompt do sistema, que será incluído na quantidade de Tokens.
tools: definição de ferramentas, que será incluída na quantidade de Tokens.
thinking: configuração de pensamento estendido.
tool_choice: configuração de seleção de ferramentas.
cache_control: configuração de controle de cache de nível superior ou de bloco de conteúdo.

messages, system, reprodução de chamadas de ferramentas, imagens de URL e blocos de conteúdo document/PDF usam a mesma estrutura estável de solicitação da API Messages.

Exemplo cURL

curl -X POST 'https://api.acedata.cloud/v1/messages/count_tokens' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "model": "claude-fable-5-1",
    "messages": [
      {
        "role": "user",
        "content": "Hello, Claude"
      }
    ]
  }'

Exemplo Python

import httpx

url = "https://api.acedata.cloud/v1/messages/count_tokens"
headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json",
}
payload = {
    "model": "claude-fable-5-1",
    "messages": [
        {
            "role": "user",
            "content": "Hello, Claude"
        }
    ],
}
response = httpx.post(url, headers=headers, json=payload)
print(response.json())

Exemplo de resultado retornado:

{
  "input_tokens": 11
}

Uso do SDK da Anthropic

A API Claude Messages Count Tokens aceita a estrutura estável de solicitação do SDK da Anthropic e pode ser chamada por meio da biblioteca anthropic. A interface usa a capacidade nativa de Count Tokens correspondente ao modelo selecionado para contar as entradas, podendo ser usada para verificar o tamanho da entrada antes de enviar uma solicitação Messages.

from anthropic import Anthropic

client = Anthropic(
    api_key="{token}",
    base_url="https://api.acedata.cloud",
)

result = client.messages.count_tokens(
    model="claude-opus-4-8",
    messages=[
        {
            "role": "user",
            "content": "Hello, Claude"
        }
    ],
)
print(result.input_tokens)

Contagem de Tokens com ferramentas

Se sua solicitação contiver definições de ferramentas, essas ferramentas também serão incluídas na quantidade de Tokens:

result = client.messages.count_tokens(
    model="claude-opus-4-8",
    messages=[
        {
            "role": "user",
            "content": "What is the weather in San Francisco?"
        }
    ],
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA"
                    }
                },
                "required": ["location"]
            }
        }
    ],
)
print(result.input_tokens)

Contagem de Tokens com prompts do sistema

Os prompts do sistema também serão incluídos na quantidade de Tokens:

result = client.messages.count_tokens(
    model="claude-opus-4-8",
    system="You are a helpful assistant that speaks Chinese.",
    messages=[
        {
            "role": "user",
            "content": "Hello"
        }
    ],
)
print(result.input_tokens)

Observações

Esta API calcula apenas a quantidade de Tokens de entrada e não produzirá nenhuma saída do modelo.
O resultado da contagem de Tokens pode ser usado para estimar o tamanho da entrada e verificar a janela de contexto; a cobrança final prevalece conforme o usage na resposta real de Messages.
Imagens, PDFs, definições de ferramentas, prompts do sistema e configuração de thinking serão incluídos no resultado de acordo com as regras de entrada do modelo selecionado.
Esta API é totalmente gratuita e não consome nenhum crédito.

Primeiros passos

Chat AI

Imagem AI

Vídeo AI

Áudio AI

Web e Dados

CAPTCHA

Identidade

Coding

Mais guias

Solicitação e uso da API Claude Messages Count Tokens

Processo de solicitação

Uso básico

Exemplo cURL

Exemplo Python

Uso do SDK da Anthropic

Contagem de Tokens com ferramentas

Contagem de Tokens com prompts do sistema

Observações

​Processo de solicitação

​Uso básico

​Exemplo cURL

​Exemplo Python

​Uso do SDK da Anthropic

​Contagem de Tokens com ferramentas

​Contagem de Tokens com prompts do sistema

​Observações

Processo de solicitação

Uso básico

Exemplo cURL

Exemplo Python

Uso do SDK da Anthropic

Contagem de Tokens com ferramentas

Contagem de Tokens com prompts do sistema

Observações