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

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

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

Базове використання

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

Приклад cURL

Приклад Python

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

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

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

Підрахунок Token з інструментами

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

Підрахунок Token із системним промптом

Системний промпт також враховується в кількості Token:

Зауваження

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