Activity Dashboard: Полный контроль над расходами на AI в OpenRouter

За последние два года мы стали свидетелями взрывного роста внедрения AI-агентов в бизнес-процессы. Компании массово интегрируют автономные системы, которые самостоятельно принимают решения, генерируют код и обрабатывают данные. Однако по мере масштабирования этих решений возникает один и тот же, пугающий многих CTO и финансовых директоров вопрос: что именно они нам стоят, и какие из них действительно окупаются?

Ответ на этот вопрос больше не должен быть предметом догадок или ручного подсчета строк в Excel. OpenRouter представляет Activity Dashboard и бета-версию Analytics API, которые дают вам беспрецедентную прозрачность. Теперь вы можете видеть стоимость каждого агента, каждой модели и каждого отдельного запроса. Это не просто статистика — это инструмент для оптимизации бюджета и повышения эффективности вашей AI-инфраструктуры.

01Начинайте с общей картины: Обзор (Overview)

Первое, что вы видите при входе в раздел Overview, — это сводка вашего использования AI «взглядом сверху». Этот интерфейс спроектирован так, чтобы дать вам мгновенное понимание текущего состояния ваших расходов и производительности. В верхней части экрана расположены пять ключевых метрик, каждая из которых сопровождается мини-графиком (sparkline) и сравнением с предыдущим периодом:

• Общие расходы (Total Spend): Сколько денег было израсходовано за выбранный период.
• Количество запросов (Requests): Общее число вызовов API.
• Объем токенов (Token Volume): Суммарное количество обработанных токенов.
• Коэффициент попадания в кэш (Cache Hit Rate): Процент запросов, которые были обработаны без повторного вычисления, что напрямую влияет на скорость и стоимость.
• Средняя стоимость за миллион токенов (Blended Cost per Million Tokens): Взвешенная средняя цена, показывающая реальную эффективность вашего микса моделей.

Но на этом возможности экрана не ограничиваются. Ниже этих ключевых показателей вы найдете детализированные виджеты, которые раскрывают структуру ваших затрат. Вы можете увидеть, какие пользователи и приложения (apps) генерируют наибольшую нагрузку, как распределяются расходы по разным моделям, и, что особенно важно, как соотносятся расходы с использованием кредитов OpenRouter и собственных ключей (BYOK — Bring Your Own Key).

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

02Тренды: Ищите изменения, а не только размеры

Если Overview показывает вам состояние системы «здесь и сейчас», то раздел Trends помогает понять динамику. Этот инструмент сортирует данные не по абсолютному размеру затрат, а по направлению движения. Здесь вы найдете панели, показывающие, что растет, а что падает.

Анализ трендов позволяет отслеживать активность по моделям, пользователям, ключам API и приложениям. Зачем это нужно? Чтобы быстро выявить аномалии. Например, вы можете заметить, что какой-то новый агент начал использовать ресурсоемкую модель в геометрической прогрессии, или что определенный инструмент начал широко использоваться в вашей организации, увеличивая нагрузку на инфраструктуру. Раннее обнаружение таких трендов позволяет предотвратить неожиданные счета в конце месяца.

03Исследуйте любой вопрос: Гибкость раздела Explore

Каждая карточка в разделах Overview и Trends является интерактивной. Кликнув на любой график, вы переходите в раздел Explore. Это мощная аналитическая среда, где вы можете самостоятельно собирать представления данных, отвечая на специфические вопросы вашего бизнеса.

Выбор метрик

В Explore вы можете выбрать одну из множества метрик для анализа. Помимо стандартных расходов и количества запросов, доступны:

• Количество токенов (разбитое на промпт, завершение, рассуждение или кэшированные).
• Коэффициент попадания в кэш.
• Средняя стоимость за миллион токенов.
• Сравнение расходов с использованием кредитов и BYOK.
• Задержка (latency) и пропускная способность, включая перцентили P50, P90 и P99.

Группировка данных

Одна из самых сильных сторон этого инструмента — возможность группировки данных по двум измерениям одновременно. Вы можете выбрать любые из следующих параметров:

• Модель и её вариант.
• Провайдер (поставщик модели).
• Ключ API, приложение, пользователь, рабочее пространство (workspace).
• Источник запроса, страна, регион данных.
• Причина завершения (finish reason), длина контекста, сессия, генерация.
• Пользовательские ID и любые классификаторы, которые вы определили самостоятельно.

Настройка отображения

Вы можете выбрать granularity (гранулярность) данных: минуту, час, день, неделю или месяц. Или же полностью убрать временную ось, чтобы получить ранжированную таблицу. Тип графика также настраивается: столбчатые диаграммы, линейные графики или точечные диаграммы (dot plots).

Используйте Explore, чтобы ответить на такие вопросы, как: «Какие приложения генерируют основную нагрузку в каждом рабочем пространстве?», «Какие модели используют наши агенты для каждого типа задач?» или «Как меняется задержка провайдеров со временем?».

Сохранение и экспорт

Не нужно каждый раз собирать отчет заново. Откройте меню опций, выберите Save current chart и дайте ему имя. В корпоративных организациях вы можете настроить права доступа: сделать график видимым только для себя или для всей организации. Кроме того, вы можете экспортировать данные любого графика в формате CSV или PDF, чтобы сразу отправить их в spreadsheets или отчеты для руководства.

04Контроль безопасности: Guardrails

Помимо финансов, OpenRouter уделяет огромное внимание безопасности. Раздел Guardrails показывает, какие правила инъекции промптов и защиты конфиденциальной информации были заблокированы, отредактированы или отмечены как подозрительные. Здесь вы можете увидеть, какие правила работают наиболее эффективно.

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

05От агрегатов к логам: Детализация запросов

Агрегированные данные в Activity Dashboard показывают вам, что что-то стало дорогим. Но следующий, самый важный вопрос: какие именно запросы?

Каждый график и ранжированная таблица в Activity связаны с логами. Кликнув на столбец за вторник, кусок стековой диаграммы по модели или строку в таблице, вы попадаете в Logs, отфильтрованные именно по этим запросам. Это мост между высокоуровневой аналитикой и технической детализацией.

Открыв любую строку в логах, вы попадаете в Generation Detail View. Здесь представлена исчерпывающая информация:

• Стоимость: Разбивка по upstream-инференсу, кэшированию, веб-поиску и обработке файлов, а также примененные скидки и экономия от кэша.
• Производительность: Задержка провайдера, пропускная способность и время до первого токена (TTFT).
• Маршрутизация: Какой провайдер обработал запрос, был ли выполнен фоллбэк на другой провайдер и причина завершения.
• Атрибуция: Приложение, ключ API и рабочее пространство, а также ID сессии и запроса, регион данных.
• Контекст: События guardrails, теги классификаторов и сырые метаданные.

Особый интерес представляет Prompt Detail View. Она отображает полный массив сообщений и «пламя» (flamegraph) оценочного количества токенов на сообщение, окрашенное по ролям: system, user, assistant и tool. Разговор, который стоит в три раза дороже, чем вы ожидали, обычно показывает себя здесь как широкая полоса вызовов инструментов или тяжелый системный промпт. Кэшированный префикс заштрихован, что позволяет визуально оценить, насколько глубоко в промпт распространяется кэш и какое именно сообщение его прервало.

Важно отметить: подсчет токенов на уровне сообщений является оценочным и основан на размере сообщения; итоговые цифры в самом запросе являются записанным фактическим использованием. Детали промптов и завершений существуют только если была включена регистрация приватных входных/выходных данных при выполнении запроса, что можно настроить в observability вашего рабочего пространства.

06Те же данные через API: Автоматизация аналитики

Все, что доступно в разделе Explore, также доступно через beta Analytics API. Это позволяет вашим агентам самостоятельно запускать анализ, получать быстрые ответы в терминале или извлекать цифры в ваши собственные дашборды. Запросы к аналитике требуют management key.

Существует два основных эндпоинта:

1. GET /api/v1/analytics/meta: Возвращает поддерживаемые метрики, измерения, операторы фильтрации и гранулярности. Рекомендуется вызывать этот эндпоинт первым, чтобы увидеть, что доступно; мы постоянно добавляем новые метрики и измерения.
2. POST /api/v1/analytics/query: Запускает запрос и возвращает те же агрегаты, из которых строятся графики в Explore.

Вот пример запроса через curl:

curl -X POST https://openrouter.ai/api/v1/analytics/query \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "metrics": ["total_usage", "tokens_total", "cache_hit_rate"],
  "dimensions": ["model"],
  "granularity": "day",
  "time_range": {"start": "2026-07-01T00:00:00Z", "end": "2026-08-01T00:00:00Z"},
  "limit": 20
}'

07Для агентов: Автономный контроль затрат

OpenRouter предлагает cost control cookbook, который ставит вашего агента во главе анализа расходов. Дайте вашему coding-агенту management key и навык openrouter-analytics, и позвольте ему провести обзор затрат в вашем аккаунте OpenRouter.

Агент находит модели, стоимость которых в несколько раз превышает среднюю blended rate организации, прослеживает их до ключей и конвейеров, ответственных за это, и возвращает ранжированные рекомендации. Мы протестировали это внутренне и обнаружили, что preview-модель сжигала около $6,2K в месяц при цене примерно в 25 раз выше средней по организации. После одного запроса на детализацию 98% этих расходов были связаны с одним ключом batch-пайплайна, выполняющим задачу, которая никогда не требовала модели уровня frontier. Исправление потребовало всего одной строки кода для замены модели. См. рецепты запросов и промпты агентов, которые мы использовали, в cookbook.

08Как начать

Откройте Activity, чтобы начать с общего обзора, или перейдите в Explore, если у вас уже есть конкретный вопрос, на который нужно ответить. Для работы из терминала получите management key и обратитесь к beta Analytics API.