Struct ModelUsage 

pub struct ModelUsage {
    pub input_tokens: u64,
    pub output_tokens: u64,
    pub reasoning_tokens: u64,
    pub cached_input_tokens: u64,
    pub cache_write_tokens: u64,
    pub cost_microusd: u64,
}

Detailed usage reported by a model provider.

Fields

input_tokens: u64

Input tokens.

output_tokens: u64

Output tokens.

reasoning_tokens: u64

Reasoning tokens, when reported separately.

cached_input_tokens: u64

Input tokens served from provider cache.

cache_write_tokens: u64

Input tokens written to provider cache.

cost_microusd: u64

Estimated or reported cost in micro-US-dollars.

Implementations

impl ModelUsage

pub fn total_tokens(self) -> u64

Returns total model tokens without double-counting usage details.

Reasoning tokens are normally a subset of output tokens, just as cached tokens are a subset of input tokens.

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 Copy for ModelUsage

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 Eq for ModelUsage

impl From<ModelUsage> for Usage

fn from(value: ModelUsage) -> Self

Converts to this type from the input type.

impl PartialEq for ModelUsage

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

Equality operator ==.

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

Inequality operator !=.

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