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 przejdź do Ace Data Cloud 控制台, aby uzyskać swój token API, który należy zachować na przyszłość.

Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zakończeniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę. Jeden token API wystarczy do korzystania ze wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi. Pierwsze zgłoszenie daje darmowy limit, który można wykorzystać bezpłatnie; w przypadku niewystarczającego limitu można doładować saldo ogólne w 控制台.

📘 Pełna dokumentacja: Claude Messages Count Tokens API →

基本使用

Ś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. najnowszy flagowy claude-fable-5-1; oryginalny claude-fable-5 pozostaje wstecznie kompatybilny.
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: konfiguracja rozszerzonego myślenia.
tool_choice: konfiguracja wyboru narzędzi.
cache_control: konfiguracja kontroli pamięci podręcznej na poziomie bloku treści lub najwyższym.

messages, system, wywołania narzędzi, obrazy URL i bloki treści dokumentów/PDF używają tej samej stabilnej struktury żądania co API wiadomości.

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

Claude Messages Count Tokens API akceptuje stabilną strukturę żądania SDK Anthropic i można go wywołać za pomocą biblioteki anthropic. Obecna wartość zwracana jest obliczana przez lokalny estimator Ace Data Cloud i nie jest dokładnym wynikiem oficjalnego tokenizera Anthropic; rzeczywista liczba tokenów dla multimodalnych, narzędzi i różnych modeli Claude może się różnić.

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 计数

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-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 计数

Systemowe komunikaty również będą wliczane do liczby tokenów:

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)

注意事项

To API oblicza tylko liczbę tokenów wejściowych i nie generuje żadnych wyników modelu.
Wyniki liczenia tokenów mogą być używane do przybliżonego oszacowania skali wejścia, nie powinny być traktowane jako dokładna podstawa do rozliczeń, kontroli okna kontekstowego lub porównań z tokenizerem modelu.
Obecny estimator nie oblicza dokładnie tokenów wizualnych/dokumentowych dla obrazów i PDF, ani nie odzwierciedla różnic w oficjalnym tokenizerze różnych modeli Claude.
To API jest całkowicie darmowe i nie zużywa żadnych limitów.

Getting Started

Czat AI

Obraz AI

Wideo AI

Audio AI

Sieć i dane

CAPTCHA

Tożsamość

Proxy

Advanced

Coding

Claude Messages Count Tokens API 申请及使用

申请流程

基本使用

cURL 示例

Python 示例

使用 Anthropic SDK

包含工具的 Token 计数

包含系统提示词的 Token 计数

注意事项

​申请流程

​基本使用

​cURL 示例

​Python 示例

​使用 Anthropic SDK

​包含工具的 Token 计数

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

​注意事项

申请流程

基本使用

cURL 示例

Python 示例

使用 Anthropic SDK

包含工具的 Token 计数

包含系统提示词的 Token 计数

注意事项