cicora.ai
Especificación de la APIObservabilidad

Uso y coste

Relaciona los metadatos de respuesta y tus propios registros de solicitudes con acciones reales del usuario.

Referencia de integración: elige los parámetros y las capacidades disponibles en la configuración de la API de tu cuenta y en el catálogo de modelos de tu entorno.

Registra metadatos de respuesta

Para una llamada, son principales los metadatos devueltos por esa respuesta: id, usage o cost solo cuando esté presente el campo correspondiente.

No supongas un endpoint de agregación independiente: un recopilador externo necesita su propio contrato publicado.

Registro de la solicitud por respuesta
typescript
const requestRecord = {
  model: selectedModel,
  status: response.status,
  responseId: responseBody.id,
  usage: responseBody.usage ?? null,
  receivedAt: new Date().toISOString(),
};

// Persist only usage fields actually returned by this response.

Modelo de datos

  • Separa las unidades de entrada, salida, caché y medios cuando se devuelvan.
  • Mantén la moneda y la unidad de medida junto a cada número.
  • No contabilices los trabajos en segundo plano sin terminar como gasto final.

Vista operativa

Crea un panel en torno al producto: usuarios, flujos, modelos, errores y latencia. Muestra cambios de comportamiento antes que un único total general.

Restringe el acceso a datos de uso con las mismas reglas aplicadas a información financiera u organizativa.