Claude Messages Count Tokens API 申请及使用

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.

Getting Started

Czat AI

Obraz AI

Wideo AI

Audio AI

Sieć i dane

CAPTCHA

Tożsamość

Proxy

Advanced

Claude Messages Count Tokens API 申请及使用

申请流程

基本使用

cURL 示例

Python 示例

使用 Anthropic SDK

包含工具的 Token 计数

包含系统提示词的 Token 计数

注意事项

​申请流程

​基本使用

​cURL 示例

​Python 示例

​使用 Anthropic SDK

​包含工具的 Token 计数

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

​注意事项

申请流程

基本使用

cURL 示例

Python 示例

使用 Anthropic SDK

包含工具的 Token 计数

包含系统提示词的 Token 计数

注意事项