Как на самом деле устроен биллинг Anthropic API

Короткий ответ: за что вы реально платите

Anthropic выставляет счёт за Claude API по токенам, с предоплатой. Вы покупаете кредиты в консоли разработчика, и каждый запрос списывает баланс по трём счётчикам: входные токены (всё, что вы отправляете), выходные токены (всё, что генерирует модель, включая токены размышления) и трафик кэша промптов (запись тарифицируется по ставке 1.25x от входной цены, а чтение по ставке 0.1x). Подписки на сам API нет, и подписка Claude Pro или Max не включает кредиты API. Выходные токены обходятся дороже всего. Claude Sonnet 4.6 стоит $3.00 за миллион входных токенов и $15.00 за миллион выходных, разрыв в 5 раз. Claude Opus 4.7 стоит $5.00 на входе и $25.00 на выходе. Если счёт оказался выше ожидаемого, в первую очередь проверьте объём выходных токенов и рост истории переписки.

Три счётчика: входные, выходные и кэш-токены

Во входные токены входит не только сообщение пользователя. Системный промпт, вся история переписки, описания инструментов, результаты вызовов инструментов и изображения считаются входными токенами в каждом запросе, где они присутствуют. Выходные токены охватывают всё, что модель пишет в ответ, а в моделях с рассуждением сюда входят и токены размышления, которые вы можете никогда не показать пользователю. Кэширование промптов является третьим счётчиком, и именно его большинство команд не использует. Вы помечаете стабильный префикс (длинный системный промпт, документ, фиксированный список инструментов) точкой останова cache_control. Первый запрос платит надбавку за запись в размере 1.25x от входной ставки для кэша по умолчанию на 5 минут; каждый запрос, повторно использующий префикс в течение этого окна, читает его по ставке 0.1x. Также доступен часовой кэш по ставке записи 2x. Ниже приведена полная тарифная сетка для двух флагманских моделей Claude по официальным розничным ценам.

Пример расчёта: один чат-бот, один день

Возьмём чат-бот поддержки на Claude Sonnet 4.6 по официальным ставкам: 10 000 запросов в день, каждый с системным промптом на 2 000 токенов плюс 1 500 токенов истории и сообщения пользователя, с ответом на 500 токенов. В таблице показана одна и та же нагрузка с кэшированным системным промптом и без него. Без кэширования день стоит $180.00, около $5 400 в месяц. Кэширование системного промпта (при условии около 300 истечений кэша в день в 5-минутном окне) снижает стоимость примерно до $128 в день, около $3 840 в месяц. Обратите внимание, что не изменилось: стоимость выходных токенов. Кэширование затрагивает только входные токены, поэтому дисциплина в отношении выходных токенов важнее любого другого отдельного рычага.

Почему счета Anthropic удивляют команды

Четыре паттерна объясняют большинство разговоров вида «почему счёт в несколько раз больше оценки». 1. Выходные токены стоят в 5 раз дороже входных, а размышление считается выходом. Оценки опираются на входную ставку, потому что её называют первой. Но длинные ответы, многословное форматирование и расширенное размышление тарифицируются по выходной ставке. Модель, которая размышляет 3 000 токенов перед тем как ответить 500 токенами, тарифицирует 3 500 выходных токенов за то, что выглядит как короткий ответ. 2. История переприсылается на каждом ходе. API не хранит состояние, поэтому каждый ход заново отправляет всю переписку как входные токены. Чат в среднем на 20 ходов стоит не в 20 раз дороже одного хода; он стоит гораздо больше, потому что 20-й ход несёт предыдущие 19 ходов как входные токены. Стоимость входных токенов растёт примерно пропорционально квадрату длины переписки, если её не обрезать или не суммировать. 3. Подписки и кредиты API разделены. Claude Pro и Max покрывают приложения Claude, а не API. Команды предполагают, что подписка покрывает трафик API, а затем обнаруживают, что консоль незаметно списывала средства с предоплаченного баланса с включённым автопополнением. 4. Всё в запросе считается входными токенами, и атрибуцию сложно проследить. Описания инструментов, результаты вызовов инструментов, изображения и системные промпты тарифицируются как входные токены в каждом запросе, где они присутствуют. Если это распределено по нескольким API-ключам, окружениям и функциям без логирования по ключам, никто не сможет сказать, какая функция потратила деньги, пока не придёт счёт.

Биллинг Anthropic и OpenAI: сравнение

Оба провайдера считают одинаково: по токенам, с раздельными ставками на вход и выход, по умолчанию с предоплаченными кредитами. Различия, которые действительно влияют на счёт, кроются в механике кэша и инструментах контроля расходов. Практическое отличие кроется в кэшировании. OpenAI применяет кэширование промптов автоматически, без платы за запись и со скидкой на кэшированную часть. Anthropic заставляет вас самостоятельно расставлять точки останова cache_control, берёт надбавку за запись и компенсирует это гораздо более дешёвым чтением по ставке 0.1x от входной цены. Для нагрузок с длинными стабильными промптами правильно настроенное кэширование Anthropic становится более сильным рычагом; настроенное неправильно (метка времени в системном промпте, нестабильный список инструментов), оно незаметно никогда не срабатывает, и вы платите полную цену плюс надбавки за запись.

Как оценить стоимость Anthropic API до запуска в продакшн

Каждый ответ API включает объект usage с точными input_tokens и output_tokens, а также cache_creation_input_tokens и cache_read_input_tokens при активном кэшировании. Этот объект и есть источник истины. Токенизаторы на клиенте, созданные для других провайдеров, занижают число токенов Claude, поэтому не оценивайте стоимость с их помощью. Порядок действий: отправьте несколько показательных запросов, прочитайте объект usage и усредните значения. Затем примените формулу: стоимость = (input_tokens / 1,000,000 x ставка_на_вход) + (output_tokens / 1,000,000 x ставка_на_выход), плюс слагаемые за запись и чтение кэша, если вы его используете. Умножьте на ожидаемый дневной объём, а для продуктов с многоходовыми диалогами добавьте запас на рост, потому что история увеличивает объём входных токенов на каждом ходе. Anthropic также предоставляет эндпоинт count_tokens, если нужно узнать количество токенов до отправки запроса.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Summarize this ticket: ..."}]
  }'

# Ответ содержит точные данные для вашей модели стоимости:
# "usage": {"input_tokens": 2412, "output_tokens": 486,
#           "cache_read_input_tokens": 0, "cache_creation_input_tokens": 0}

Пять способов снизить счёт за Anthropic API

Именно в пятой тактике шлюз оправдывает своё существование. APIsRouter представляет собой OpenAI-совместимый шлюз, который логирует модель, входные токены, выходные токены и точную стоимость в долларах для каждого запроса и каждого API-ключа, так что у каждой функции или окружения есть свой ключ и своя строка в панели использования. В каталоге Claude Sonnet 4.6 стоит $2.40 за входные и $12.00 за выходные токены за миллион, а Claude Opus 4.7 $4.00 и $20.00, это на 20% ниже официального прайса, оплата по факту использования без подписки; первое пополнение на /topup удваивается. Подключение существующей интеграции OpenAI SDK сводится к изменению в две строки:

• Кэшируйте длинные стабильные префиксы. Системный промпт или документ, повторяющийся в запросах, тарифицируется по десятой части входной ставки при каждом чтении из кэша после первой записи.
• Обрезайте историю и ограничивайте max_tokens. Суммируйте или отбрасывайте старые ходы вместо их повторной отправки, и задайте max_tokens под потребности задачи, чтобы неконтролируемый ответ не тарифицировал тысячи лишних выходных токенов.
• Маршрутизируйте по задаче, а не по привычке. Оставьте Opus для шагов, которым он действительно нужен, а массовую классификацию, извлечение данных и черновики отправляйте в более дешёвые модели, такие как deepseek-v4-flash или glm-5.
• Используйте батчинг для всего асинхронного. Batches API обрабатывает запросы в течение 24 часов по половинной цене, что идеально подходит для бэкфиллов, оценок и ночных заданий.
• Сделайте видимость стоимости по каждому ключу частью вашего трафика. Большинство неожиданных счетов на самом деле являются проблемой атрибуции: никто не может сказать, какая функция или клиент потратил деньги, пока не придёт счёт.

from openai import OpenAI

client = OpenAI(
    api_key="sk-APIsRouter-...",
    base_url="https://api.apisrouter.com/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Summarize this ticket: ..."}],
)

# Количество токенов приходит в каждом ответе; консоль шлюза
# дополнительно записывает точную стоимость этого запроса по этому ключу.
print(response.usage.prompt_tokens, response.usage.completion_tokens)

Частые вопросы