Перейти к основному содержанию
Автокэш RuAPI сам ставит метки cache_control в запросы к Claude, где клиент их не поставил, поэтому, если между ходами меньше 5 минут, повторно отправленный контекст оплачивается по цене чтения из кэша — у Claude Sonnet 5.5 это в 20 раз дешевле обычного ввода. Настраивать ничего не нужно. Не путайте его с «автоматическим кэшированием» Anthropic: там клиент сам ставит одну метку cache_control на верхнем уровне запроса, а автокэш RuAPI в основном срабатывает, когда клиент не поставил ни одной метки. Зачем это нужно: кэширование промптов у Claude включает клиент — Anthropic считает повторно отправленный контекст по цене кэша, только если в запросе стоит метка cache_control. Claude Code и многие другие инструменты, работающие в нативном формате Anthropic, ставят метки сами. А инструменты, которые вызывают Claude в OpenAI-совместимом формате, часто меток не ставят — и тогда с каждым новым ходом вся история диалога заново оплачивается по полной цене.

Сколько стоит диалог с Claude с кэшем и без

Инструмент для программирования на каждом ходу заново отправляет весь диалог: системный промпт, содержимое файлов, прошлые ответы и результаты инструментов. Чем длиннее диалог, тем больше входных токенов на каждом ходу. Грубый расчёт: диалог на 30 ходов с Claude Sonnet 5.5, контекст постепенно растёт с 20 тыс. до 100 тыс. токенов, между ходами меньше 5 минут. Цены — по странице цен на 20.11.2026; цена в вашем аккаунте может быть ниже. У Sonnet 5.5 чтение из кэша в 20 раз дешевле обычного ввода; запись на 25% дороже обычного ввода, но окупается первым же чтением на следующем ходу. У Opus 5.5 и Fable 5.2 чтение из кэша стоит $0,24 за 1 млн токенов — в 20 и в 40 раз дешевле обычного ввода соответственно.

Почему в OpenAI-совместимом формате кэша часто нет

  • Собственный OpenAI-совместимый слой Anthropic кэширование промптов не поддерживает (документация Anthropic, проверено 15.10.2026).
  • Многие инструменты для программирования и самописные агенты с провайдером «OpenAI Compatible» не отправляют cache_control. Для Cline мы проверили это по исходному коду (16.10.2026). Без меток кэш не работает, даже если шлюз его поддерживает.
  • Наши данные это подтверждают: за 30 дней до запуска автокэша 4 ноября 2026 года ни один запрос к Claude в OpenAI-формате не прочитал ничего из кэша.

Как RuAPI ставит метки кэша автоматически

Если клиент не поставил ни одной метки, RuAPI ставит за вас не больше двух меток с кэшем на 5 минут:
  1. Системный промпт (вместе с описаниями инструментов) — если точно такие же уже приходили с тем же ключом к той же модели за последние 5 минут. Так системный промпт может читаться из кэша даже на первом ходу нового диалога и в сериях одиночных запросов (например, при пакетной обработке).
  2. Последнее сообщение пользователя или результат инструмента — если диалог продолжается и прошлый ход был, как правило, не больше 5 минут назад. Тогда в кэш попадает вся история.
Если запись в кэш три раза подряд не окупилась, автокэш ставится на паузу — обычно на 1 час и только для этого диалога или этого системного промпта. Кроме того, на ключ и модель действуют два общих ограничения: по сумме переплаты за запись и по изменениям ранней части переписки. Если клиент поставил метки сам, работают его метки; RuAPI добавляет одну метку в конце, только если клиент поставил 1–2 метки далеко от конца переписки, после них остаётся большой кусок без кэша и диалог продолжается в пределах 5 минут. Работает в обоих форматах: OpenAI-совместимом (/v1/chat/completions) и нативном (/v1/messages). Все правила — в разделе Кэширование промптов.

Сколько экономит автокэш на деле

С вечера 18.11.2026, когда вышла новая версия автокэша, до утра 20.11.2026:
  • в запросах к Claude, где метки поставил RuAPI, около 90% входных токенов прочитано из кэша. Это доля токенов: запись в кэш на 25% дороже ввода, поэтому в деньгах доля экономии немного ниже. Запросы, где RuAPI меток не ставил (например, ход после долгого перерыва), в эту цифру не входят;
  • чем длиннее диалог и чем реже перерывы больше 5 минут, тем больше экономия.

Где посмотреть свою экономию

  • Главная страница консоли: как только за последние 7 дней накопится экономия, на главной появится карточка «Кэш сэкономил вам» с суммой за сегодня и за последние 7 дней (данные обновляются примерно каждые 5 минут).
  • Журнал запросов: откройте запись — строка «Экономия на кэше» показывает, на сколько этот запрос обошёлся дешевле, чем без кэша (она есть, только если экономия действительно была); «Токены из кэша» — сколько прочитано из кэша.
  • Ответ API: в OpenAI-формате — usage.prompt_tokens_details.cached_tokens, в формате Anthropic — usage.cache_read_input_tokens.

Когда всё же лучше ставить метки самому

  • Между ходами часто большие перерывы: поставьте метки сами и используйте кэш на час ("ttl": "1h", запись вдвое дороже обычного ввода).
  • Свой код: в OpenAI-совместимом формате достаточно одной метки cache_control на верхнем уровне запроса — RuAPI, как и нативный API Anthropic, перенесёт её на последнее сообщение.
  • Если инструмент позволяет выбрать провайдер Anthropic — выбирайте его: в нативном формате кэшем управляет сам инструмент, это надёжнее всего.
Примеры кода — в разделе Кэширование промптов.

Чем это отличается от OpenRouter

Согласно документации OpenRouter, для кэша Claude метки cache_control должен ставить клиент: одну метку на верхнем уровне запроса (работает у перечисленных в документации провайдеров Claude) или до четырёх меток в блоках содержимого. О том, что OpenRouter ставит метки сам, если клиент их не поставил, в документации не сказано. Сведения об OpenRouter — по его официальной документации (проверено 20.11.2026).

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

Нет, автокэш работает для всех ключей.
Запись в кэш на 25% дороже обычного ввода, поэтому RuAPI ставит метку, только когда кэш, скорее всего, будет прочитан. Если записи раз за разом не окупаются, автокэш сам ставится на паузу.
Нет. У них кэш срабатывает сам: если начало запроса достаточно длинное и совпадает с прошлым запросом, оно обычно берётся из кэша.
Нет. Claude Code сам ставит метку на последнее сообщение, и RuAPI ничего не добавляет.
Частые причины:
  • больше 5 минут не было запросов, и кэш истёк;
  • это первый ход нового диалога: из кэша читаются только системный промпт и инструменты, если такие же приходили за последние 5 минут;
  • клиент каждый ход меняет начало переписки — например, добавляет в системный промпт текущее время;
  • записи несколько раз подряд не окупились, и автокэш на паузе;
  • запрос слишком короткий: меньше минимальной длины кэша для этой модели.

Дальше