Панель Activity OpenRouter и API Analytics: руководство по отслеживанию расходов ИИ

Если вы запускаете ИИ-агентов через OpenRouter, рано или поздно возникает вопрос: сколько они стоят и какие модели сжигают бюджет. Панель Activity OpenRouter и бета-версия API Analytics дают ответ по каждому агенту, модели и запросу. Это руководство для разработчиков и команд, которые уже используют OpenRouter и хотят разобраться в расходах на модели. Контроль расходов начинается с прозрачности по моделям, ключам и типам запросов.

Что нужно для работы с панелью Activity OpenRouter

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

Активный аккаунт на OpenRouter с подключённым способом оплаты или BYOK.
Хотя бы один рабочий API-ключ, через который идут запросы.
Ключ управления (management key) для доступа к API Analytics. Создаётся в настройках рабочего пространства отдельно от обычного API-ключа.

Без ключа управления вы сможете работать только с веб-интерфейсом панели Activity. API Analytics OpenRouter требует именно ключ управления, не обычный API-ключ. Если у вас нет отдельного ключа, создайте его в настройках до начала работы.

Обзор: панель Activity OpenRouter на главном экране

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

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

Анализ тенденций использования OpenRouter

Раздел Trends берёт те же данные, что и Overview, но сортирует по динамике, а не по размеру. Панель показывает, что растёт, а что снижается, по моделям, пользователям, API-ключам и приложениям.

Используйте Trends для отслеживания расходов ИИ-агентов: расходы агентов видны в динамике, что позволяет вовремя заметить агента с неконтролируемым ростом затрат, определить, какая новая модель набирает популярность, или увидеть, как инструмент распространяется по организации. Если расходы агентов внезапно выросли за неделю, Trends покажет это раньше, чем общий отчёт по затратам. Раннее обнаружение аномалии позволяет ограничить лишние расходы до того, как они станут значительными.

Пользовательские представления в Explore для отслеживания расходов ИИ

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

Выберите метрику: расходы, количество запросов, токены (промпт, генерация, токены рассуждений и кэшированные токены), частоту попадания в кэш, среднюю стоимость за миллион токенов, BYOK против кредитов, задержку и пропускную способность по перцентилям P50, P90 и P99.

Группировка до двух измерений: модель, вариант, провайдер, API-ключ, приложение, пользователь, рабочее пространство, источник, страна, регион данных, причина завершения ответа (finish_reason), длина контекста, сессия, поколение, пользовательские ID или любое измерение классификаторов, которое вы настроили.

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

Сохраняйте нужные представления. Откройте меню параметров, выберите "Save current chart" и назовите его. В организации можно выбрать видимость: "Only me" или "Everyone in my organization". Скачивайте CSV или PDF для отправки данных в таблицу или отчёт.

Детализация запросов через панель Activity OpenRouter

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

Кликните на столбик вторника, на срез одной модели в накопительной диаграмме или на строку в таблице. Вы попадёте в логи, отфильтрованные по этим запросам. Откройте любую строку, чтобы увидеть детали генерации.

Блок "Стоимость" показывает вывод на стороне провайдера, кэширование, веб-поиск, обработку файлов, плюс применённые скидки и экономию от кэша. Блок "Производительность" содержит задержку провайдера, пропускную способность и время до первого токена. Блок "Маршрутизация" указывает, какой провайдер обслужил запрос, был ли откат к другому и причину завершения. Блок "Атрибуция" фиксирует приложение, API-ключ и рабочее пространство за запросом, ID сессии и запроса, регион данных. Блок "Контекст" показывает события guardrail, теги классификаторов и сырые метаданные.

В представлении промпта отображается полный массив сообщений и график распределения оценочных токенов по сообщениям, окрашенных по ролям: system, user, assistant, tool. Если разговор стоит втрое дороже ожидаемого, причина обычно видна как широкая полоса вызовов инструментов или тяжёлый системный промпт. Кэшированный префикс закрашен, поэтому видно, до какого места держался кэш и какое сообщение сломало его.

Запрос аналитики через API Analytics OpenRouter

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

Для запросов к API OpenRouter нужен ключ управления. Два эндпоинта работают с аналитикой.

GET /api/v1/analytics/meta возвращает поддерживаемые метрики, измерения, операторы фильтров и гранулярности. Вызовите его первым, чтобы увидеть, что доступно. Новые метрики и измерения добавляются регулярно, поэтому стоит проверять обновления.

POST /api/v1/analytics/query выполняет сам запрос и возвращает агрегаты, на которых строятся графики Explore. Пример запроса расходов на модели:


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
  }'

Замените $OPENROUTER_API_KEY на ваш ключ управления. Этот запрос вернёт расходы на модели, общий объём токенов и частоту попадания в кэш с разбивкой по дням.

Контроль расходов ИИ-агентов с помощью cookbook

OpenRouter опубликовал cookbook по контролю затрат, который ставит агента на анализ расходов. Дайте вашему кодирующему агенту ключ управления и навык openrouter-analytics, и пусть он проведёт аудит вашего аккаунта.

Агент находит модели, которые стоят в разы дороже средней ставки за миллион токенов, отслеживает их до ключей и конвейеров, и возвращает ранжированные рекомендации. Внутри OpenRouter применили этот подход и нашли превью-модель, которая сжигала около 6 200 долларов в месяц при ставке примерно в 25 раз выше средней по организации. Один запрос на детализацию показал, что 98% суммы пришёлся на один ключ пакетного конвейера, выполнявший задачу, которой не нужна была модель верхнего уровня. Исправление заняло одну строку кода.

Рецепты запросов и промпты для агента, которые использовала команда OpenRouter, описаны в cookbook. Это готовый шаблон для контроля расходов ИИ-агентов, который можно адаптировать под свою инфраструктуру.

Частые проблемы с API OpenRouter и панелью Activity

Пустая панель Activity. Если графики пустые, проверьте, что запросы идут через OpenRouter, а не через прямые ключи провайдеров. Логи собираются только для запросов через платформу.

Нет данных в API Analytics. Убедитесь, что используете ключ управления, а не обычный API-ключ. Обычный ключ вернёт ошибку 403. Создайте отдельный ключ управления в настройках рабочего пространства.

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

Приватные логи недоступны. Детали промптов и генераций доступны только если private input/output logging был включён при выполнении запроса. Включите эту опцию в настройках рабочего пространства до того, как данные понадобятся. Ретроактивно включить логирование для уже выполненных запросов нельзя.

Заключение: отслеживание расходов ИИ с OpenRouter

Панель Activity и API Analytics OpenRouter дают полный контроль над расходами на модели: от общего обзора до отдельного запроса. Начните с Overview, перейдите в Trends для поиска аномалий, соберите пользовательское представление в Explore, а для автоматизации подключите API и cookbook. Это превращает вопрос «сколько мы потратили на модели?» в конкретные данные с возможностью действовать. Начните с раздела Activity, чтобы определить основные источники расходов.