Как считаются токены, стоимость и резервы
В SimpleRouter баланс и розничные тарифы ведутся в USD. Для текстовых моделей входные и выходные токены могут иметь разные ставки. Цена за 1M токенов — единица тарифа, а не минимальная покупка: стоимость рассчитывается по учтённому объёму конкретного запроса.
Что означают входные и выходные токены
Вход включает данные, переданные модели в поддерживаемом формате запроса. Выход — учтённый результат генерации. Точное разбиение usage зависит от модели и протокола. Дополнительные измерения, например кэш или инструменты, нужно проверять в опубликованном тарифе модели.
Для простого запроса без дополнительных измерений расчёт состоит из двух частей: входные токены × ставка входа / 1 000 000 и выходные токены × ставка выхода / 1 000 000. Итоговая запись запроса содержит применённую версию тарифа и учтённый usage.
Пример расчёта
Это учебный пример, а не действующий тариф: при ставках 0.13 $ за вход и 0.65 $ за выход, запрос на 1 000 входных и 200 выходных токенов стоит 0.00026 $. Малые списания не превращаются в 0.01 $ за каждый запрос только из-за отображения цены с двумя знаками.
Розничная ставка за единицу публикуется с округлением вверх до цента. Например, рассчитанная ставка 0.128572 $ становится 0.13 $ за 1M токенов. Далее стоимость запросов считается уже по этой опубликованной ставке с точностью денежного учёта сервиса.
Зачем нужен резерв перед генерацией
Перед платным запросом система проверяет доступные средства и ограничения ключа, затем резервирует бюджет запроса. Зарезервированная сумма временно недоступна другим запросам того же аккаунта. Задавайте разумный предел длины ответа: он влияет на необходимый бюджет.
После получения подтверждённых данных об использовании система выполняет итоговый расчёт и освобождает неиспользованный резерв. Если результат или расход пока неизвестны, запрос может оставаться на сверке. Не считайте исчезнувшее соединение подтверждением бесплатной отмены.
Как проверить списание и пополнение
Сопоставьте ID запроса, модель, ключ, usage, версию тарифа и итоговую сумму в истории кабинета. Сумма «Доступно» отличается от суммы «В резерве»: это разные состояния одних средств. Для запроса без окончательного расчёта ориентируйтесь на его статус, а не на предварительную оценку.
Для рублёвого пополнения котировка использует курс ЦБ РФ для доллара плюс 2 RUB за 1 USD. Например, при базовом курсе 82 RUB расчётный курс составит 84 RUB. Доступный платёжный метод и окончательную сумму зачисления показывает котировка перед оплатой; средства зачисляются после подтверждения платежа.
Инструкции для разработчиков
API-ключи моделей и лимиты расходов
Как создать API-ключ SimpleRouter для одной модели, задать лимит, отслеживать расходы и заменить секрет без потери истории.
Как считаются токены, стоимость и резервы
Расчёт стоимости API в USD: входные и выходные токены, цена за 1M токенов, резерв до запроса и итоговое списание в SimpleRouter.
Потоковые ответы API и безопасные повторы
Как подключить потоковый ответ модели, обработать завершение или обрыв соединения и проверить результат платного запроса в SimpleRouter.