Claude Messages Count Tokens API 申请及使用

Claude Messages Count Tokens API pode calcular a quantidade de Tokens de entrada de uma mensagem sem realmente criar a mensagem, incluindo a contagem de Tokens de ferramentas, imagens e documentos. Isso é muito útil quando é necessário estimar custos ou verificar se a entrada excede os limites de contexto do modelo. Este documento descreve principalmente o processo de uso da Claude Messages Count Tokens API.

申请流程

Para usar a Claude Messages Count Tokens API, primeiro acesse o Painel de Controle da Ace Data Cloud para obter seu Token de API, que deve ser guardado para uso futuro.

Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, convidando-o a se registrar e fazer login. Após a conclusão, você será redirecionado de volta para a página atual. Um Token de API é suficiente para acessar todos os serviços da plataforma, não sendo necessário solicitar um para cada serviço. A primeira solicitação oferece um crédito gratuito, permitindo uma experiência sem custo; quando o crédito estiver baixo, você pode recarregar o saldo geral no painel de controle.

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

基本使用

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

model: escolha o modelo Claude a ser utilizado, como o mais recente claude-fable-5-1; o antigo claude-fable-5 ainda é compatível.
messages: array de mensagens de entrada, onde cada mensagem contém role (papel) e content (conteúdo).

Parâmetros opcionais comuns:

system: prompt do sistema, que será contabilizado na quantidade de Tokens.
tools: definição de ferramentas, que será contabilizada na quantidade de Tokens.
thinking: configuração de pensamento expandido.
tool_choice: configuração de escolha de ferramentas.
cache_control: configuração de controle de cache em nível de bloco de conteúdo ou de nível superior.

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

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

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())

返回结果示例：

{
  "input_tokens": 11
}

使用 Anthropic SDK

A Claude Messages Count Tokens API aceita a estrutura de solicitação estável do SDK da Anthropic e pode ser chamada através da biblioteca anthropic. O valor retornado atualmente é calculado pelo estimador local da Ace Data Cloud e não é o resultado preciso do tokenizer oficial da Anthropic; a contagem real de tokens para multimodal, ferramentas e diferentes modelos Claude pode ter variações.

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)

包含工具的 Token 计数

Se sua solicitação incluir definições de ferramentas, essas ferramentas também serão contabilizadas 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)

包含系统提示词的 Token 计数

Os prompts do sistema também serão contabilizados 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)

注意事项

Esta API calcula apenas a quantidade de Tokens de entrada e não gera nenhuma saída do modelo.
Os resultados da contagem de Tokens podem ser usados para uma estimativa aproximada da escala de entrada, não devendo ser considerados como base para cobrança precisa, controle de janela de contexto ou comparação de tokenizers do modelo.
O estimador atual não calcula com precisão os tokens visuais/documentais de imagens e PDFs, e não reflete as diferenças do tokenizer oficial entre diferentes modelos Claude.
Esta API é completamente gratuita e não consome nenhum crédito.

Primeiros passos

Chat AI

Imagem AI

Vídeo AI

Áudio AI

Web e Dados

CAPTCHA

Identidade

Proxy

Avançado

Coding

Claude Messages Count Tokens API 申请及使用

申请流程

基本使用

cURL 示例

Python 示例

使用 Anthropic SDK

包含工具的 Token 计数

包含系统提示词的 Token 计数

注意事项

​申请流程

​基本使用

​cURL 示例

​Python 示例

​使用 Anthropic SDK

​包含工具的 Token 计数

​包含系统提示词的 Token 计数

​注意事项

申请流程

基本使用

cURL 示例

Python 示例

使用 Anthropic SDK

包含工具的 Token 计数

包含系统提示词的 Token 计数

注意事项