Como usar el panel Activity de OpenRouter y la API Analytics (v2)

Toda empresa que pasó los últimos dos años desplegando agentes se hace la misma pregunta: ¿cuánto cuestan y cuáles valen la pena? El panel Activity OpenRouter y la API Analytics en beta responden a eso por cada agente, modelo y solicitud. Esta guía cubre desde abrir Activity hasta consultar la API OpenRouter desde la terminal. Si administras una cuenta de OpenRouter y quieres entender adónde va tu dinero, esto es para ti.

Requisitos previos para usar el panel Activity de OpenRouter

Antes de empezar, asegúrate de tener lo siguiente:

Una cuenta activa en OpenRouter con solicitudes registradas. Sin datos de uso, el panel aparece vacío.
Una clave de gestión para la API Analytics. Las claves de inferencia normales devuelven error 403. Genera una desde la configuración de tu espacio de trabajo.
Navegador actualizado. No hay app de escritorio ni móvil.
Para consultar la API desde la terminal, curl o un cliente HTTP.

Un detalle que conviene saber: sin registro de entrada y salida activado, los prompts no aparecen en los logs. Actívalo en Workspace, luego Observability. Si lo activas después, las solicitudes anteriores siguen sin contenido. No se recupera.

1. Overview: el panorama de tu uso OpenRouter

Al abrir Activity, Overview muestra cinco métricas en la parte superior: gasto total, número de solicitudes, volumen de tokens, tasa de aciertos de caché y coste promedio por millón de tokens. Cada una trae un mini-gráfico y una comparación con el periodo anterior.

Debajo, tarjetas adicionales muestran tus usuarios y apps principales, el gasto en modelos desglosado, créditos de OpenRouter frente a gasto BYOK, el volumen de solicitudes por modelo y el desglose de tokens de prompt y completado. Todo eso te da una lectura rápida del uso OpenRouter sin tocar nada. Directo al grano.

Consejo Pro: si el coste promedio por millón de tokens sube sin que hayas cambiado modelos, revisa la tasa de aciertos de caché. Una caída en caché suele explicar el aumento.

Trends ordena los mismos datos por movimiento en lugar de tamaño. Un panel muestra qué sube y qué baja. Úsalo para detectar un agente descontrolado, un modelo nuevo ganando tracción o una herramienta extendiéndose por la organización.

Guardrails muestra lo que tus reglas de inyección de prompt e información sensible bloquearon, redactaron o marcaron. Filtra por espacio de trabajo o clasificador para ver de dónde viene. Despliega una tarjeta para el desglose completo de patrones detectados.

2. Explore: vistas para el seguimiento de costes IA

Cada tarjeta de Overview y Trends enlaza con Explore, donde construyes la vista tú mismo. Aquí el seguimiento de costes IA se vuelve específico.

Elige una métrica: gasto, conteo de solicitudes, tokens (prompt, completado, razonamiento o cacheados), tasa de aciertos de caché, coste promedio por millón de tokens, gasto BYOK frente a créditos, o latencia y rendimiento en P50, P90 y P99.
Agrupa por hasta dos dimensiones: modelo, variante, proveedor, clave de API, app, usuario, espacio de trabajo, origen, país, región de datos, motivo de finalización, longitud de contexto, sesión, generación, IDs de usuario personalizados o cualquier dimensión de clasificador definida.
Define la agregación temporal: minuto, hora, día, semana o mes. Si quitas el eje de tiempo, obtienes una tabla clasificada.
Elige el tipo de gráfico: barras, líneas o diagrama de puntos.

Para guardar la vista, abre el menú de opciones, elige "Save current chart" y ponle nombre. En una organización, decides si es visible solo para ti o para todo el equipo. Exporta con "Download CSV" o "Download PDF" directamente a una hoja de cálculo o informe.

3. De gráficos a logs: rastrear el gasto en modelos

Los agregados te dicen que algo se encareció. La siguiente pregunta es: ¿qué solicitudes? Cada gráfico y tabla clasificada en Activity enlaza con los logs que hay detrás.

Pulsa la barra de un día, la porción de un modelo en un gráfico apilado o una fila en una tabla. Aterrizas en los logs filtrados a esas solicitudes, conservando el agrupamiento y el intervalo temporal.

Abre cualquier fila para ver el detalle de la generación. Cuatro bloques de información:

Coste: inferencia upstream, caché, búsqueda web y procesamiento de archivos, más descuentos y ahorros aplicados.
Rendimiento: latencia del proveedor, rendimiento y tiempo hasta el primer token.
Enrutamiento: qué proveedor sirvió la solicitud, si hubo respaldo a otro y el motivo de finalización.
Atribución: la app, clave de API y espacio de trabajo responsables, más IDs de sesión y solicitud.

La vista de Prompt renderiza el array completo de mensajes y un gráfico de flama con los tokens estimados por mensaje, coloreado por rol: system, user, assistant y tool. El prefijo cacheado aparece sombreado. Ves hasta dónde llegó el caché y qué mensaje lo rompió.

Una conversación que cuesta tres veces lo esperado suele mostrarlo aquí. Una banda ancha de llamadas de herramienta o un prompt del sistema pesado. Ahí está el problema.

4. Consultar la API Analytics de OpenRouter por código

Todo lo de Explore también está disponible con la API Analytics OpenRouter en beta. Los mismos datos, otro canal. Permite que tu agente ejecute el análisis, obtén una respuesta en la terminal o lleva los números a tus propios dashboards.

Necesitas una clave de gestión. Dos endpoints:

GET /api/v1/analytics/meta devuelve las métricas, dimensiones, operadores de filtro y granularidades soportadas. Llámalo primero. OpenRouter añade métricas y dimensiones con frecuencia.

POST /api/v1/analytics/query ejecuta la consulta y devuelve los mismos agregados que los gráficos de Explore.

Ejemplo de consulta para ver el gasto en modelos a lo largo de un mes:


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

Cambia las dimensiones y métricas según lo que necesites. La API devuelve los mismos datos que ves en Explore, así que puedes construir tus propios informes o integrarlos en sistemas internos.

5. Automatizar el control del gasto de agentes

El recetario de control de costes pone a tu agente de código al mando del análisis. Dale una clave de gestión y el skill openrouter-analytics. El agente busca los modelos que cuestan un múltiplo de tu tarifa promedio por millón de tokens, los rastrea hasta las claves y pipelines responsables, y devuelve recomendaciones priorizadas.

OpenRouter ejecutó esto internamente y encontró un modelo preliminar quemando unos 6.200 dólares al mes a aproximadamente 25 veces la tarifa promedio de la organización. Una consulta de profundización después, el 98% del gasto se rastreó a una única clave de pipeline por lotes ejecutando una tarea que nunca necesitó un modelo de vanguardia. La solución fue un cambio de modelo. Una línea de código.

Las recetas de consulta y los prompts de agente usados están en el recetario oficial. Es un punto de partida para controlar los costes de agentes IA sin revisar manualmente cada panel.

Errores comunes con la API OpenRouter y el panel Activity

Error 403 al consultar la API Analytics. Estás usando una clave de inferencia en lugar de una clave de gestión. Genera una clave de gestión desde la configuración del espacio de trabajo y úsala en la cabecera Authorization.

Logs sin contenido de prompt. El registro de entrada y salida no estaba activado cuando se hizo la solicitud. Actívalo en Workspace, luego Observability. El contenido anterior no se recupera.

Datos limitados a 31 días. Algunas métricas leen registros de generación en crudo en lugar de datos pre-agregados. Latencia, rendimiento, ID de generación, región de datos y filtros de clasificador se limitan a 31 días. Las consultas con agregación por hora también tienen ese límite, y las de minuto a una ventana de 3 horas. Activity te avisa cuando recorta el rango.

No ves los prompts de otro espacio de trabajo. Los miembros de la organización pueden no tener permiso para leer los prompts de otro espacio de trabajo. Revisa los permisos con el administrador.

Conclusión: controlar los costes de agentes IA

El panel Activity OpenRouter y la API Analytics te dan visibilidad completa sobre el uso OpenRouter: desde el panorama general de gasto hasta la solicitud individual que explica un pico de costes. Empieza en Overview, entra en Explore para preguntas específicas, usa la API OpenRouter para automatizar informes y deja que un agente haga el trabajo pesado de análisis. Si administras agentes en producción, estas herramientas te dicen exactamente dónde va tu dinero y qué hacer al respecto. Abre Activity en OpenRouter y revisa tus gastos ahora mismo.