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

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

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

Базовое использование

Путь запроса Claude Messages Count Tokens API — /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, поддерживает ввод изображений и адаптивное мышление; его официальные справочные цены за миллион Token для ввода, вывода и чтения кэша составляют 2, 10 и 0,20 доллара США соответственно.
  • messages: массив входных сообщений, где каждое сообщение содержит role (роль) и content (содержимое).
Часто используемые необязательные параметры:
  • system: системный промпт, учитывается в количестве Token.
  • tools: определения инструментов, учитываются в количестве Token.
  • thinking: конфигурация расширенного мышления.
  • tool_choice: конфигурация выбора инструмента.
  • cache_control: конфигурация управления кэшем верхнего уровня или уровня блока содержимого.
messages, system, воспроизведение вызовов инструментов, URL-изображения и блоки содержимого document/PDF используют такую же стабильную структуру запросов, как и Messages API.

Пример cURL

Пример Python

Пример возвращаемого результата:

Использование Anthropic SDK

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

Подсчёт Token с инструментами

Если ваш запрос содержит определения инструментов, эти инструменты также будут учитываться в количестве Token:

Подсчёт Token с системным промптом

Системный промпт также будет учитываться в количестве Token:

Примечания

  • Этот API вычисляет только количество входных Token и не создаёт никакого вывода модели.
  • Результат подсчёта Token может использоваться для предварительной оценки размера ввода и проверки окна контекста; окончательная тарификация определяется usage в фактическом ответе Messages.
  • Изображения, PDF, определения инструментов, системные промпты и конфигурация thinking будут учитываться в результате согласно правилам ввода выбранной модели.
  • Этот API полностью бесплатен и не расходует никакой лимит.