# 1.4.0

## Metrics API

### Features

#### Conversation usage metrics

* Use `/v1/metrics/:metric` to retrieve time-series data for a single metric, grouped by granularity (`hour`, `day`, `week`, `month`, `year`, `all`).
* Use `/v1/metrics/bulkAll` to retrieve multiple metrics aggregated over a time range in one request.
* Filter by `projectId`, `traceId`, and `context`, such as `assistantId`, to scope results to a project, conversation, or Assistant.
* Metrics with a configured price calculation include a `pricing` field with the estimated cost in EUR. Unpriced time-series metrics omit this field.
* Use `padMissing=true` on `/v1/metrics/:metric` to fill gaps in the time series with zero values.
* Added use-case guides for [conversation metrics](/docs/use-case-fetch-conversation-metrics) and [Assistant metrics](/docs/use-case-fetch-metrics-for-a-specific-assistant).

#### 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 `Variable` model is available in Blueprints.
