1.4.0
Metrics API
Features
Conversation usage metrics
- Use
/v1/metrics/:metricto retrieve time-series data for a single metric, grouped by granularity (hour,day,week,month,year,all). - Use
/v1/metrics/bulkAllto retrieve multiple metrics aggregated over a time range in one request. - Filter by
projectId,traceId, andcontext, such asassistantId, to scope results to a project, conversation, or Assistant. - Metrics with a configured price calculation include a
pricingfield with the estimated cost in EUR. Unpriced time-series metrics omit this field. - Use
padMissing=trueon/v1/metrics/:metricto fill gaps in the time series with zero values. - Added use-case guides for conversation metrics and Assistant metrics.
Available metrics
exchangeCount: number of conversation exchanges.duration: total conversation duration in seconds.indivisibleDuration: billed duration blocks in minutes.usage.stt.audioDuration: speech-to-text audio duration.usage.tts.characters: characters sent to text-to-speech.usage.conversational.inputTextTokens: input tokens consumed by the conversational AI.usage.conversational.outputTextTokens: output tokens produced by the conversational AI.usage.conversational.cachedTextTokens: cached tokens reused by the conversational AI.usage.realtime.inputTextTokens: input text tokens for realtime AI.usage.realtime.outputTextTokens: output text tokens for realtime AI.usage.realtime.inputAudioTokens: input audio tokens for realtime AI.usage.realtime.outputAudioTokens: output audio tokens for realtime AI.usage.realtime.cachedAudioTokens: cached audio tokens for realtime AI.usage.postProcessing.inputTextTokens: input tokens for post-processing.usage.postProcessing.outputTextTokens: output tokens for post-processing.usage.postProcessing.cachedTextTokens: cached tokens for post-processing.
Data API
- The
Variablemodel is available in Blueprints.
Last modified on