Struct TokenUsage 

pub struct TokenUsage {
    pub input_tokens: u64,
    pub output_tokens: u64,
    pub cache_creation_input_tokens: u64,
    pub cache_read_input_tokens: u64,
    pub cache_creation: Option<CacheCreation>,
    pub service_tier: Option<String>,
}

Token usage with granular cache tracking

Captures detailed token usage for cost analysis.

Fields

input_tokens: u64

Input tokens (new prompt tokens)

output_tokens: u64

Output tokens (response tokens)

cache_creation_input_tokens: u64

Cache creation tokens (tokens added to cache, 25% more expensive)

cache_read_input_tokens: u64

Cache read tokens (tokens read from cache, 90% discount)

cache_creation: Option<CacheCreation>

Cache creation details

service_tier: Option<String>

Service tier (for pricing)

Implementations

impl TokenUsage

pub fn total(&self) -> u64

Total tokens (input + output)

pub fn total_input(&self) -> u64

Total input including cache operations

pub fn effective_input(&self) -> f64

Effective input tokens with cache discount (90% for reads)

pub fn calculate_cost(&self, model: &str) -> Option<f64>

Calculate cost in USD based on model pricing

pub fn format_cost(&self, model: &str) -> String

Format cost as human-readable string

pub fn estimated_cost(&self) -> f64

👎Deprecated since 0.1.0:

Use calculate_cost(model) instead

Calculate approximate cost (deprecated)

Trait Implementations

impl Clone for TokenUsage

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TokenUsage

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

Formats the value using the given formatter.

impl Default for TokenUsage

fn default() -> Self

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 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.