Перейти к основному содержанию
POST https://api.ethereal.llc/v1/messages/count_tokens
Возвращает оценку, во сколько входных токенов обойдётся запрос — удобно для планирования расходов до того, как реально его отправить. Формат тела запроса совпадает с Anthropic Messages.
Эндпоинт без авторизации: API-ключ не нужен, баланс не списывается.

Заголовки

ЗаголовокЗначение
Content-Typeapplication/json

Параметры тела

model
string
обязательно
ID модели: claude-opus-4-8, claude-sonnet-4-6 или claude-haiku-4-5.
messages
array
обязательно
Список сообщений. Каждое — { "role": "user" | "assistant", "content": string }.
system
string | array
Опциональный системный промпт — строка или массив текстовых блоков.

Пример запроса

curl https://api.ethereal.llc/v1/messages/count_tokens \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "system": "Ты лаконичный ассистент.",
    "messages": [
      { "role": "user", "content": "Объясни рекурсию в одном предложении." }
    ]
  }'

Ответ

{
  "input_tokens": 28
}
input_tokens — это оценка, а не точное значение; используй её для планирования расходов. Реальное списание считается по полю usage из Messages (Тарифы).