> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Messages Count Tokens API 申请 та використання

> Claude AI 集成指南 - XHuoAPI

Claude Messages Count Tokens API може без фактичного створення повідомлень обчислити кількість вхідних токенів для одного повідомлення, включаючи токени для інструментів, зображень та документів. Це дуже корисно, коли потрібно оцінити витрати або перевірити, чи не перевищує вхідне повідомлення обмеження контексту моделі.

Цей документ в основному описує процес використання Claude Messages Count Tokens API.

## Процес подачі заявки

Щоб використовувати Claude Messages Count Tokens API, спочатку можна перейти на сторінку [Claude Messages Count Tokens API](https://api.xhuoapi.ai/documents/claude-messages-count-tokens) та натиснути кнопку «Acquire», щоб отримати необхідні для запиту облікові дані.

Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, запрошуючи вас зареєструватися та увійти. Після входу або реєстрації ви автоматично повернетеся на цю сторінку.

Цей API повністю безкоштовний, не вимагає витрат.

## Основне використання

Запит до Claude Messages Count Tokens API має шлях `/v1/messages/count_tokens`, що відповідає офіційному API Anthropic. Нам потрібно надати принаймні два обов'язкових параметри:

* `model`: вибір моделі Claude, наприклад, `claude-sonnet-4-5-20250929`, `claude-opus-4-20250514` тощо.
* `messages`: масив вхідних повідомлень, кожне з яких містить `role` (роль) та `content` (вміст).

Звичайні необов'язкові параметри:

* `system`: системне підказування, яке враховується в кількості токенів.
* `tools`: визначення інструментів, яке враховується в кількості токенів.
* `thinking`: розширена конфігурація мислення.

### cURL приклад

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/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 приклад

```python theme={null}
import httpx

url = "https://api.xhuoapi.ai/v1/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())
```

Приклад повернутого результату:

```json theme={null}
{
  "input_tokens": 11
}
```

### Використання Anthropic SDK

Claude Messages Count Tokens API повністю сумісний з офіційним SDK Anthropic, можна безпосередньо використовувати бібліотеку `anthropic` для виклику.

```python theme={null}
from anthropic import Anthropic

client = Anthropic(
    api_key="{token}",
    base_url="https://api.xhuoapi.ai/v1",
)

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

## Обчислення токенів з інструментами

Якщо ваш запит містить визначення інструментів, ці інструменти також будуть враховані в кількості токенів:

```python theme={null}
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)
```

## Обчислення токенів з системними підказками

Системні підказки також будуть враховані в кількості токенів:

```python theme={null}
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)
```

## Зверніть увагу

* Цей API лише обчислює кількість вхідних токенів, не генеруючи жодного виходу моделі.
* Результати підрахунку токенів можна використовувати для оцінки витрат на виклик Claude Messages API.
* Способи токенізації можуть відрізнятися для різних моделей, будь ласка, використовуйте той же параметр моделі, що й для фактичного виклику.
* Цей API повністю безкоштовний, не витрачає жодних ресурсів.