Доступно

Баланс и стоимость API-запросов

Как читать тарифы Токенмоста, рассчитать стоимость входных и выходных токенов, учитывать резервы и контролировать расходы ключа.

API Токенмоста работает

Базовый адрес — https://tokenmost.ru/v1. Создайте ключ в личном кабинете, выберите модель в каталоге и отправьте первый запрос. Методы, которые ещё не доступны, отмечены отдельно.

Как это устроено

Текстовые модели обычно тарифицируют входные и выходные токены отдельно. До отправки сервис резервирует максимально возможную сумму по параметрам запроса, а после подтверждённого ответа списывает фактическую стоимость и освобождает остаток резерва.

Что потребуется

  • Точный ID модели и её актуальные розничные тарифы из каталога.
  • Оценка объёма входного контекста и максимальной длины ответа.
  • Отдельный бюджет API-ключа для приложения или окружения.

Порядок работы

  1. Откройте карточку модели и запишите тарифы входа и выхода за один миллион токенов.
  2. Оцените вход: системная инструкция, сообщения пользователя, история и результаты инструментов.
  3. Задайте разумный max_tokens или max_output_tokens — он влияет на требуемый резерв.
  4. Рассчитайте ожидаемую сумму и добавьте запас на историю, инструменты и сетевые повторы.
  5. После запроса сверяйте фактическое списание и состояние резерва в истории операций.

Готовая конфигурация

Формула для текстовой модели

стоимость =
  входные_токены × тариф_входа / 1 000 000
  + выходные_токены × тариф_выхода / 1 000 000

Учебный расчёт на JavaScript

const inputTokens = 2_000;
const outputTokens = 500;
const inputRate = 100;  // ₽ за 1 млн токенов
const outputRate = 400; // ₽ за 1 млн токенов

const rubles =
  (inputTokens * inputRate + outputTokens * outputRate) / 1_000_000;
console.log(rubles.toFixed(2)); // 0.40 ₽

Что учесть

Числа в примере показывают формулу и не являются тарифом конкретной модели. Для рабочего расчёта используйте текущие цены из каталога.

Баланс, резерв и списание

Доступный баланс не включает средства, временно удержанные активными запросами. Резерв не является окончательным списанием: после подтверждённого результата неиспользованный остаток освобождается. Неизвестный исход сохраняет резерв до сверки, чтобы исключить двойной расход.

Почему длинная история дороже

Вход включает весь переданный контекст, а не только последнее сообщение. Если клиент каждый раз отправляет длинную историю, одни и те же токены оплачиваются в каждом новом запросе.

Другие единицы тарификации

Изображения, речь, транскрибация и отдельные поставщики могут использовать фиксированную цену, символы, секунды или другую единицу. Смотрите единицу и поддерживаемые параметры в карточке конкретной модели.

Ошибки и диагностика

HTTP 402 при положительном балансе

Проверьте доступный остаток, активные резервы и оставшийся бюджет конкретного ключа.

Резерв больше ожидаемой цены

Уменьшите максимальный ответ и проверьте, не отправляет ли клиент длинную историю или инструменты.

Операция долго остаётся активной

Не повторяйте платный запрос с новым Idempotency-Key. Сначала проверьте историю и статус исходной операции.

Расчёт не совпадает

Проверьте единицу тарификации, отдельно вход и выход, точную версию модели и фактическое число токенов в квитанции.

Источники и связанные инструкции

Читайте дальше

← Все инструкции