Observabilidad y buenas prácticas

Mide coste y tokens por llamada, etiqueta el tráfico, protege las keys y fija límites de gasto antes de que te pille la factura.

4 de junio de 2026 6 slides 5 min de lectura

OpenRouter · Producció

Observabilidad y buenas prácticas

Saber qué gastas, dónde y por qué — antes de que la factura te lo explique.
El panel de actividad

OpenRouter ofrece un panel de actividad y uso donde ves llamadas, modelos, tokens y coste. Es el primer sitio donde mirar cuando el gasto sube sin saber por qué.
Coste y tokens por llamada

Cada respuesta lleva datos de uso y hay un endpoint que te detalla el coste exacto de una generación. Registra modelo y coste en cada llamada y tendrás trazabilidad real, no estimaciones.

Consultar el coste de una generación

# Exemple: consultar les dades d'una generació pel seu id
curl https://openrouter.ai/api/v1/generation?id=$GEN_ID \
  -H "Authorization: Bearer $OPENROUTER_API_KEY"

# Etiqueta el trànsit a cada crida amb capçaleres
#   HTTP-Referer: https://elmeuapp.com
#   X-Title: El meu app
# així el panell agrupa l'ús per aplicació.

Etiqueta y protege

Pon HTTP-Referer y X-Title en las peticiones para identificar de dónde viene cada llamada. Y lo de siempre: las keys viven en el servidor, se rotan y tienen límites de gasto configurados.
Checklist de buenas prácticas

Antes de dar por cerrada la integración, repasa:
- Keys solo en el servidor, rotadas periódicamente.
- Límites de gasto fijados en la cuenta y por key.
- Modelo y coste registrados en cada llamada.
- Tráfico etiquetado con HTTP-Referer y X-Title.
- Cadena de fallbacks y timeouts en su sitio.
- Catálogo de modelos revisado de vez en cuando.
OpenRouter · Producción arlaf.dev

Leer la nota completa

Una integració que funciona no és el mateix que una integració que controles. A producció necessites saber, en tot moment, què gastes, amb quin model i d’on ve cada crida. Això és observabilitat, i a OpenRouter la tens a tret.

Mesurar cost i tokens

El panell d’activitat i ús és el teu punt de partida: hi veus crides, models emprats, tokens i cost acumulat. Per a una traçabilitat fina, cada resposta porta dades d’ús (tokens d’entrada i sortida) i hi ha un endpoint de generació que et dóna el cost exacte d’una crida concreta a partir del seu identificador.

La regla d’or: registra model i cost a cada crida als teus logs. Quan la factura pugi, no endevinaràs — ho sabràs.

Nota: el nom exacte de l’endpoint de generació i els camps que retorna poden canviar. Contrasta’ls amb la documentació actual d’OpenRouter abans de construir-hi a sobre.

Etiquetar el trànsit

Afegint les capçaleres HTTP-Referer i X-Title a cada petició, el panell pot agrupar l’ús per aplicació. Si tens diversos projectes o entorns compartint compte, és la manera de saber qui gasta què sense barrejar-ho tot.

Protegir-se de sorpreses

La seguretat i el control de cost van junts:

Keys al servidor — mai al navegador ni a un repositori. I rota-les cada cert temps o davant qualsevol sospita de filtració.
Límits de despesa — configura’ls al compte i, si pots, per key. Un bug amb un bucle de crides no t’hauria de buidar el saldo.
Revisa el catàleg — els models apareixen, es deprecien i canvien de preu. El slug que avui és el millor cost/qualitat potser d’aquí a uns mesos ja no ho és. Una ullada periòdica al catàleg et manté optimitzat.

Amb cost mesurat, trànsit etiquetat, keys protegides i límits a lloc, la teva integració deixa de ser una caixa negra i passa a ser una cosa que pots operar amb confiança.