Lovely RouterДокументация
Получить ключ
Аккаунт

Использование и логи

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

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

СтраницаЧто показывает
ОбзорРасходы, надёжность и задержки во времени, по группам каналов и по моделям
ЛогиКаждый запрос к модели с токенами, списанием и таймингами
ИнструментыКаждый запуск инструмента данных и браузерного агента с результатами и списанием
Браузерный агент → HistoryВаши недавние запуски браузера с шагами и ответами
API-ключиРасходы за всё время и последнее использование каждого ключа
ОплатаБаланс, зачисления и ежедневные расходы

Панель обзора#

Обзор подводит итоги вашего трафика по всем ключам за последние 24 часа, 7, 30 или 90 дней.

МетрикаЗначение
РасходыСумма списаний за период и число запросов
Success rateДоля успешных запросов и число неудачных
P95 TTFT95-й перцентиль времени до первого токена и среднее значение
ThroughputСреднее число выходных токенов в секунду
Cache hit rateДоля входных токенов, прочитанных из кеша промптов
БалансТекущий баланс и число активных ключей

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

Запуски инструментов данных и браузерного агента учитываются в расходах. Они относятся к группе tools, а в разбивке По модели отображаются как tool: и id инструмента, например tool:browser-agent.

Логи#

В Логах перечислены ваши запросы к моделям, сначала новые, по 50 за раз. Фильтруйте по группе каналов, модели, API-ключу (если ключей больше одного) или статусу (Успешно или Ошибка) и нажимайте Загрузить ещё, чтобы смотреть дальше в прошлое.

СтолбецЗначение
ВремяКогда начался запрос. Наведите курсор, чтобы увидеть точное время.
МодельId модели. ⇢ отмечает потоковый запрос.
ГруппаГруппа каналов, обслужившая запрос
СтатусHTTP-статус, возвращённый вам
ВходВходные токены, включая записанные в кеш промптов
Из кешаВходные токены, прочитанные из кеша промптов
ВыходВыходные токены, включая токены рассуждений
TTFTВремя до первого токена (потоковые запросы)
Tok/sВыходных токенов в секунду
СписаниеСколько стоил вам запрос

Нажмите на строку, чтобы увидеть подробности: ID запроса, Ключ, с которого он сделан, Формат API (anthropic, openai или gemini), общую Задержку, Запись кеша и Токены рассуждений, долю Попадание в кеш, тип Ошибки для неудачного запроса и Affinity. В конце подробностей есть кнопка Спросить поддержку об этом запросе, которая открывает обращение в поддержку с уже заполненным id.

AffinityЗначение
newПервый запрос диалога
stickyСледующий ход, оставшийся на канале своего диалога, чтобы можно было повторно использовать кеш промптов
explicitУдержан вместе с остальными по id сессии, который отправил ваш клиент
noneНет диалога, который нужно удерживать вместе

Почему affinity влияет на стоимость, объясняется в разделе Кеширование промптов.

Что попадает в логи#

  • Каждый запрос к модели, прошедший проверки ключа и баланса, успешный или нет. Неудачные запросы показывают свой статус и тип ошибки, и за них списывается $0.
  • Запросы, отклонённые заранее, не логируются и никогда не оплачиваются: отсутствующий или недействительный ключ, тело не в формате JSON, неизвестная модель, модель вне списка разрешённых для ключа, нулевой баланс или превышение лимита частоты ключа. Ошибку получает непосредственно ваш код.

Логи и история запусков инструментов хранятся 90 дней.

ID запросов#

Каждый ответ модели содержит заголовок x-lovely-request-id, например req_3f9c1a7e5b2d4c6e8a0b1d2f. Это ID запроса, показанный в Логах. Каждая ошибка тоже его содержит. Запроса, отклонённого заранее (неверный ключ, нулевой баланс, неизвестная модель), в Логах нет, но поддержка всё равно может отследить его по id.

Записывайте id в свои логи и указывайте его, когда обращаетесь в поддержку по конкретному вызову.

curl -sD - -o /dev/null https://lovelyrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model": "gpt-6.1-sol", "messages": [{"role": "user", "content": "Hi"}]}' \
  | grep -i '^x-lovely'

Ответы также содержат x-lovely-group — группу каналов, обслужившую запрос. Запуски инструментов и браузера вместо этого определяются по id запуска (run_… или brun_…).

Запуски инструментов#

Раздел Инструменты показывает ваши запуски, результаты и расходы за последние 30 дней, а затем каждый запуск с инструментом, статусом (succeeded, running, failed, timed out или stopped), числом полученных результатов из максимума, списанием и id запуска. У выполняющегося запуска вместо списания показана зарезервированная сумма. Запуски браузерного агента тоже перечислены здесь.

Тот же список доступен через API:

cURL
curl "https://lovelyrouter.com/v1/tools/runs?limit=20" \
  -H "Authorization: Bearer $LOVELY_API_KEY"

У каждого запуска есть charge_usd (null до расчёта) и reserved_usd (резерв на время выполнения). См. Запуск инструмента.

Запуски браузера#

Вкладка History на странице Браузерный агент показывает ваши последние 50 запусков со статусом, целью, числом шагов и временем старта. Нажмите на запуск, чтобы увидеть его шаги, ответ и извлечённые данные. Через API вызовите GET /v1/browser/runs или GET /v1/browser/runs/{id}, чтобы получить один запуск с его списанием. См. Браузерный агент.

Сверка списаний#

Баланс меняется по двум причинам: зачисления его увеличивают, использование уменьшает.

  • Зачисления: пополнения, активированные коды, реферальные начисления и бесплатный кредит; они перечислены в блоке История кредита на странице Оплата.
  • Использование: запросы к моделям в Логах, а также запуски инструментов и браузера в разделе Инструменты.
  • Резервы: незавершённые запуски удерживают свою максимальную стоимость до расчёта, а затем возвращают неиспользованное.

Чтобы проверить один ключ, сравните его столбец Потрачено в разделе API-ключи, который учитывает запросы к моделям, запуски инструментов и браузера, с его запросами в Логах.

Небольшие расхождения обычно объясняются так:

  • Расчёт занимает секунды. Списания записываются в течение нескольких секунд после завершения запроса, поэтому итоги, снятые при высокой нагрузке, могут немного отставать.
  • Прерванные потоки оплачиваются за обработанное. Если закрыть поток до финального события с данными об использовании, выходные токены оплачиваются по оценке уже отправленного вам текста. См. Потоковая передача.
  • Столбец «Списание» — источник истины. Это сумма, списанная с вашего баланса за запрос. Цены за токен указаны в списке моделей.

Связь с поддержкой#

Откройте Поддержку в панели и нажмите Новый запрос. Если вопрос касается конкретного вызова, укажите id запроса (req_…) или id запуска (run_…, brun_…); из строки в Логах кнопка Спросить поддержку об этом запросе подставит его за вас. Ответы появляются на той же странице, а пункт Поддержка на боковой панели показывает значок, когда приходит новый. Отвечайте в обращении, чтобы добавить подробности, или отметьте его как решённое.