Struct TokenUsage 

pub struct TokenUsage {
    pub input: u64,
    pub output: u64,
    pub cache_read: u64,
    pub cache_write: u64,
}

Normalized token usage for a single turn, in canonical billable classes.

Producing this from provider-specific usage payloads (Chat Completions, Responses, Anthropic) is a separate concern; this layer only consumes it.

Fields

input: u64

Non-cached input (prompt) tokens.

output: u64

Total billable output (completion) tokens.

Providers report reasoning tokens as a subset of the completion token count (OpenAI output_tokens_details.reasoning_tokens ⊆ output_tokens, Chat Completions completion_tokens_details.reasoning_tokens ⊆ completion_tokens), so a normalizer must never add reasoning tokens on top of this field — that double-bills every reasoning turn.

cache_read: u64

Cache-read (cache-hit) input tokens, billed at the cache-read rate.

cache_write: u64

Cache-write (cache-creation) tokens, billed at the cache-write rate.

Trait Implementations

impl Clone for TokenUsage

fn clone(&self) -> TokenUsage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TokenUsage

impl Debug for TokenUsage

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

Formats the value using the given formatter.

impl Default for TokenUsage

fn default() -> TokenUsage

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TokenUsage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TokenUsage

impl PartialEq for TokenUsage

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for TokenUsage

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 TokenUsage