Перейти к основному содержанию
Стоимость запроса Rock API зависит от модели, фактически использованной группы и применимых правил расчёта. Проверяйте актуальный каталог и цены, а завершённые запросы сверяйте с журналами использования. Одна базовая цена не определяет итоговое списание. Единой гарантированной скидки для всех моделей и вызовов API нет.

Валюта и единицы

В карточке модели запишите точный идентификатор, способ расчёта, выбранную группу, валюту и единицу цены. Доступность и тарифы меняются; отдельный фиксированный прайс здесь не поддерживается. Используйте указанную валюту: суммы USD и CNY нельзя смешивать. Баланс и расход могут отображаться в настроенной валюте или единицах квоты. Внутренняя квота — единица учёта, а не количество токенов модели. В заказе пополнения отдельно проверяйте валюту платежа и зачисленный баланс.

Способы расчёта

По использованию: каждая оплачиваемая категория умножается на свою ставку. Если кеш, изображения или аудио оплачиваются отдельно, не прибавляйте их повторно к обычному входу или выходу. Поля usage у поставщиков имеют разную семантику; используйте нормализованные категории из детализации списания. За вызов: расчёт использует цену единицы и оплачиваемое количество. Для изображений и задач могут учитываться качество или длительность. Токенная формула не подходит модели с оплатой за вызов. Динамически: выражение цены может зависеть от длины контекста, категорий токенов или условий запроса. Сервис сохраняет правило и множитель группы для запроса и использует этот снимок при окончательном расчёте. Проверяйте применённую ступень в журнале: минимальная показанная ставка может не подходить вашему запросу. Для фиксированной токенной ставки:
При оплате за вызов используйте цена единицы * количество, при динамической — соответствующее правило. Последовательно используйте базовые ставки или ставки с уже учтённой группой: не применяйте множитель дважды. Окончательное списание также включает перевод во внутреннюю квоту и округление.

Группа и пополнение — разные расчёты

Множитель группы меняет расход относительно настроенной базовой цены модели. Индивидуальная ставка аккаунта или автоматический выбор группы могут повлиять на результат. Проверяйте фактическую группу и множитель в записи запроса. Цена пополнения определяет, сколько вы платите за зачисляемый баланс. Она может зависеть от платёжных настроек, группы аккаунта или скидки на пополнение. Это отдельный расчёт от множителя потребления API. Сверяйте платёж и зачисление в заказе. Сам множитель группы не гарантирует скидку относительно публичного прайса поставщика. Подписки и продления в каталоге OpenAPI регулируются планом и условиями выбранного сервиса. Проверяйте их отдельно от токенных цен моделей.

Резервирование и окончательное списание

Перед отправкой поставщику сервис может зарезервировать расчётную квоту, в том числе запас на выходные токены. Временное изменение баланса может превышать итоговую стоимость. Проверка баланса и квоты ключа API может отклонить запрос до отправки. Когда использование известно, расчёт списывает разницу или возвращает неиспользованный резерв. Неуспешный запрос без завершённого расчёта может перейти в обработку отмены резерва. Для прерванного потока или асинхронной задачи проверяйте соответствующий журнал: код HTTP сам по себе не определяет итоговую стоимость. Возврат резерва — корректировка учёта, а не обещание возврата платежа. Условия возвратов и продлений смотрите в заказе или описании сервиса.

Сверить завершённый запрос

  1. Сохраните время, идентификатор модели, название ключа API, группу, доступный ID запроса или задачи, ответ usage и важные параметры. Перед передачей удалите ключи и частные данные.
  2. Найдите завершённую запись в журнале использования или задач. Проверьте модель, группу, способ расчёта, категории или количество и окончательный расход.
  3. Пересчитайте по ставкам и множителям этой записи. Для динамического расчёта проверьте сохранённое правило и ступень. В зависимости от типа запроса детали могут содержать billing_mode, matched_tier, group_ratio и user_group_ratio.
  4. Сравнивайте в одинаковой валюте и единицах, учитывая конверсию квоты и округление. Платёж пополнения сверяйте с его заказом, а не с отдельным вызовом.
Если расхождение сохраняется, передайте время, ID, обезличенное использование и расчёт через канал поддержки в панели управления. Текущий тариф может отличаться от правила, сохранённого для старого запроса.

Следующие шаги