llm4s-docs/org.llm4s/org.llm4s.llmconnect/org.llm4s.llmconnect.model/ModelUsage

ModelUsage

org.llm4s.llmconnect.model.ModelUsage

See theModelUsage companion object

@Stable

final case class ModelUsage

Accumulates token and cost statistics for a single model across one or more requests.

totalCost is stored as BigDecimal to avoid floating-point accumulation drift that would occur when summing many Double values; incoming Option[Double] costs are converted once via BigDecimal.decimal on first contact.

Value parameters

inputTokens: cumulative prompt tokens sent to the model
outputTokens: cumulative completion tokens received from the model
requestCount: number of API calls attributed to this model
thinkingTokens: cumulative extended-thinking tokens (Anthropic only; zero for other providers)
totalCost: cumulative estimated cost in USD; BigDecimal(0) when cost data is unavailable Build one with ModelUsage.apply and change it with the with* setters; the constructor and copy are private, so a new field never breaks callers. The constructor keeps its defaults because the JSON codec fills a missing key from them.

Attributes

Companion: object
Source: UsageSummary.scala
Graph
Supertypes: trait Serializable

trait Product

trait Equals

class Object

trait Matchable

class Any
Show all