Observabilitat i bones pràctiques
Mesura cost i tokens per crida, etiqueta el trànsit, protegeix les keys i fixa límits de despesa abans que t'enxampi la factura.
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.