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

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

Щоб використовувати Claude Messages Count Tokens API, спочатку перейдіть до Ace Data Cloud консолі, щоб отримати ваш API Token, залиште його на випадок потреби. Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, запрошуючи вас зареєструватися та увійти, після чого ви автоматично повернетеся на цю сторінку. Один API Token достатньо для виклику всіх послуг платформи, не потрібно окремо подавати заявку на кожну послугу. Перший запит на отримання токена надає безкоштовний ліміт, щоб ви могли безкоштовно спробувати; якщо ліміт вичерпано, ви можете поповнити загальний баланс в консолі.
📘 Повна документація: Claude Messages Count Tokens API →

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

Запит до Claude Messages Count Tokens API має шлях /v1/messages/count_tokens, що відповідає офіційному API Anthropic. Нам потрібно надати принаймні два обов’язкових параметри:
  • model: вибір моделі Claude, наприклад, остання флагманська claude-fable-5-1; стара claude-fable-5 все ще сумісна.
  • messages: масив вхідних повідомлень, кожне з яких містить role (роль) та content (вміст).
Звичайні необов’язкові параметри:
  • system: системне підказування, яке враховується в кількості токенів.
  • tools: визначення інструментів, яке враховується в кількості токенів.
  • thinking: конфігурація розширеного мислення.
  • tool_choice: конфігурація вибору інструментів.
  • cache_control: конфігурація контролю кешування на верхньому або блочному рівні.
messages, system, виклики інструментів, URL зображень та блоки вмісту документів/PDF використовують таку ж стабільну структуру запиту, як і Messages API.

cURL приклад

Python приклад

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

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

Claude Messages Count Tokens API приймає стабільну структуру запиту Anthropic SDK, яку можна викликати через бібліотеку anthropic. Поточне значення повертається локальним оцінювачем Ace Data Cloud і не є точним результатом офіційного токенізатора Anthropic; фактична кількість токенів для мультимодальних, інструментальних та різних моделей Claude може відрізнятися.

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

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

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

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

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

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