Struct ModelUsage 

pub struct ModelUsage {
    pub requests: u64,
    pub input_tokens: u64,
    pub output_tokens: u64,
    pub cache_read_tokens: u64,
    pub cache_write_tokens: u64,
    pub reasoning_tokens: u64,
    pub counterfactual_requests: u64,
    pub counterfactual_input_tokens: u64,
    pub counterfactual_billed_tokens: u64,
    pub measured: MeasuredSlice,
}

Cumulative real token counts for one model. Cost is derived at read time so a pricing-table change re-values historical usage consistently.

Fields

requests: u64

input_tokens: u64

output_tokens: u64

cache_read_tokens: u64

cache_write_tokens: u64

reasoning_tokens: u64

counterfactual_requests: u64

Requests whose free count_tokens probe answered (#701) — the rows the verified-savings pair below covers. serde(default) keeps pre-#701 usage files loadable.

counterfactual_input_tokens: u64

Provider-counted input tokens the covered requests would have billed WITHOUT lean-ctx (sum of probe answers on the original bodies).

counterfactual_billed_tokens: u64

Input-side tokens those same requests actually billed (input + cache read + cache write) — same request, same moment, no confound.

measured: MeasuredSlice

The turns whose response carried the provider’s own USD charge (OpenRouter usage accounting, #1179). Their tokens are inside the totals above; pricing subtracts this slice and books its measured USD instead of a table estimate. serde(default) keeps older files loadable.

Trait Implementations

impl Clone for ModelUsage

fn clone(&self) -> ModelUsage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ModelUsage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ModelUsage

fn default() -> ModelUsage

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ModelUsage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ModelUsage

fn eq(&self, other: &ModelUsage) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ModelUsage

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ModelUsage