Перейти к содержанию

POST messages/count_tokens — Anthropic

POST /anthropic/api/v1/messages/count_tokens считает входные токены без генерации ответа. Доступны только модели с поддержкой подсчета; поля описаны в документации Anthropic Count Tokens.

curl https://hub.coreinfra.ai/anthropic/api/v1/messages/count_tokens \
-H "x-api-key: $COREINFRA_API_KEY" \
-H 'anthropic-version: 2023-06-01' \
-H 'Content-Type: application/json' \
-d '{"model":"claude-haiku-4-5-20251001","messages":[{"role":"user","content":"2 + 2"}]}'

Форма ответа, где N — фактическое целое число входных токенов:

{"input_tokens": N}

Отличия от API Anthropic​

  • Ключ принимается в x-api-key или Authorization: Bearer; при наличии обоих используется x-api-key.
  • Вызов не оплачивается и не резервирует средства. Потоковый ответ не используется.
  • Доступность генерации для модели не означает доступность подсчета. Каталог Messages включает только модели, для которых есть подсчет токенов.
  • Поле inference_geo и бета-флаг fast-mode-2026-02-01 в anthropic-beta игнорируются.
  • Изображения и документы принимаются только в кодировке base64 (или текстом); ссылки на внешние ресурсы и file_id отклоняются со статус-кодом 400.

Для моделей OpenAI запрос преобразуется из формата Messages, а результат возвращается в поле input_tokens. При таком подсчете учитываются model, системные инструкции, сообщения и совместимые пользовательские инструменты (правила отбора инструментов те же, что при конвертации Messages); параметры генерации, рассуждений, формата вывода, context_management, citations, cache_control и настройки отложенной загрузки инструментов не конвертируются и игнорируются.

Ошибки​

  • 400 — модель не поддерживает подсчет токенов, нарушена политика вложений или структура запроса не позволяет конвертацию (в том числе при полной потере tools или tool_choice).
  • 502 — ошибка на стороне провайдера модели при выполнении запроса.

Формат ошибок приведен в разделе Anthropic API; общие ошибки описаны в общем справочнике.