cicora.ai
API-specificatieObserveerbaarheid

Gebruik en kosten

Koppel antwoordmetadata en uw eigen aanvraaglogboeken aan echte gebruikersacties.

Integratiereferentie: kies parameters en beschikbare mogelijkheden uit de API-instellingen van uw account en de modelcatalogus voor uw omgeving.

Antwoordmetadata vastleggen

Voor één aanroep zijn de metadata die dat antwoord retourneert leidend: id, usage of cost alleen wanneer het overeenkomende veld aanwezig is.

Ga niet uit van een afzonderlijk aggregatie-endpoint: een externe collector heeft een eigen gepubliceerd contract nodig.

Aanvraagregistratie per antwoord
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.

Gegevensmodel

  • Houd invoer-, uitvoer-, cache- en media-eenheden gescheiden wanneer ze worden geretourneerd.
  • Bewaar valuta en meeteenheid naast elk getal.
  • Tel onafgeronde achtergrondtaken niet op als definitieve uitgaven.

Operationeel overzicht

Bouw een dashboard rond het product: gebruikers, workflows, modellen, fouten en latentie. Het maakt gedragsveranderingen eerder zichtbaar dan één totaalcijfer.

Beperk toegang tot gebruiksgegevens met dezelfde regels die gelden voor financiële of organisatorische informatie.