Przejdź do głównej treści
Claude Messages Count Tokens API może obliczyć liczbę tokenów wejściowych dla wiadomości bez faktycznego tworzenia wiadomości, w tym liczenie tokenów dla narzędzi, obrazów i dokumentów. Jest to bardzo przydatne, gdy trzeba oszacować koszty lub sprawdzić, czy wejście przekracza ograniczenia kontekstu modelu. Dokument ten głównie opisuje proces korzystania z Claude Messages Count Tokens API.

​
申请流程

Aby korzystać z Claude Messages Count Tokens API, najpierw można przejść na stronę Claude Messages Count Tokens API i kliknąć przycisk „Acquire”, aby uzyskać potrzebne poświadczenia. Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zalogowaniu lub rejestracji automatycznie wrócisz na bieżącą stronę. API jest całkowicie darmowe, nie wymaga zużycia limitu.

​
基本使用

Ścieżka żądania dla Claude Messages Count Tokens API to /v1/messages/count_tokens, zgodna z oficjalnym API Anthropic. Musimy podać co najmniej dwa wymagane parametry:
  • model: wybór modelu Claude, np. claude-sonnet-4-5-20250929, claude-opus-4-20250514 itp.
  • messages: tablica wiadomości wejściowych, każda wiadomość zawiera role (rola) i content (treść).
Często używane opcjonalne parametry:
  • system: systemowy komunikat, który będzie wliczany do liczby tokenów.
  • tools: definicja narzędzi, która będzie wliczana do liczby tokenów.
  • thinking: rozszerzona konfiguracja myślenia.

​
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-sonnet-4-5-20250929",
    "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-sonnet-4-5-20250929",
    "messages": [
        {
            "role": "user",
            "content": "Hello, Claude"
        }
    ],
}
response = httpx.post(url, headers=headers, json=payload)
print(response.json())
返回结果示例： 
{
  "input_tokens": 11
}

​
使用 Anthropic SDK

Claude Messages Count Tokens API jest w pełni kompatybilne z oficjalnym SDK Anthropic, można bezpośrednio użyć biblioteki anthropic do wywołania. 
from anthropic import Anthropic

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

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

​
包含工具的 Token 计数

Jeśli Twoje żądanie zawiera definicje narzędzi, te narzędzia również będą wliczane do liczby tokenów: 
result = client.messages.count_tokens(
    model="claude-sonnet-4-5-20250929",
    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 计数

Systemowe komunikaty również będą wliczane do liczby tokenów: 
result = client.messages.count_tokens(
    model="claude-sonnet-4-5-20250929",
    system="You are a helpful assistant that speaks Chinese.",
    messages=[
        {
            "role": "user",
            "content": "Hello"
        }
    ],
)
print(result.input_tokens)

​
注意事项

  • To API oblicza tylko liczbę tokenów wejściowych, nie generuje żadnych wyjść modelu.
  • Wyniki liczenia tokenów mogą być używane do oszacowania kosztów wywołania Claude Messages API.
  • Różne modele mogą mieć różne sposoby tokenizacji, proszę używać tego samego parametru modelu, co w rzeczywistym wywołaniu.
  • To API jest całkowicie darmowe, nie zużywa żadnych limitów.