pub struct ModelUsage { /* private fields */ }Expand description
Normalized token accounting for exactly one model attempt.
Input and output counts are inclusive. A present cached-input count is a subset of input; a present reasoning count is a subset of output. Missing optional breakdowns mean the provider did not report them and must never be converted to zero. Adapters normalize Anthropic cache categories into input and Gemini thought tokens into output before construction.
Implementations§
Source§impl ModelUsage
impl ModelUsage
Sourcepub const fn new(
input_tokens: TokenCount,
cached_input_tokens: Option<TokenCount>,
output_tokens: TokenCount,
reasoning_tokens: Option<TokenCount>,
) -> Result<Self, ModelUsageError>
pub const fn new( input_tokens: TokenCount, cached_input_tokens: Option<TokenCount>, output_tokens: TokenCount, reasoning_tokens: Option<TokenCount>, ) -> Result<Self, ModelUsageError>
Constructs normalized usage and validates inclusive-subset arithmetic.
§Errors
Returns ModelUsageError when a reported breakdown exceeds its
inclusive total or input plus output overflows.
Sourcepub const fn input_tokens(&self) -> TokenCount
pub const fn input_tokens(&self) -> TokenCount
Returns inclusive normalized input tokens.
Sourcepub const fn cached_input_tokens(&self) -> Option<TokenCount>
pub const fn cached_input_tokens(&self) -> Option<TokenCount>
Returns the provider-reported cached-input subset when available.
Sourcepub const fn output_tokens(&self) -> TokenCount
pub const fn output_tokens(&self) -> TokenCount
Returns inclusive normalized generated-output tokens.
Sourcepub const fn reasoning_tokens(&self) -> Option<TokenCount>
pub const fn reasoning_tokens(&self) -> Option<TokenCount>
Returns the provider-reported reasoning subset when available.
Sourcepub fn total_tokens(&self) -> TokenCount
pub fn total_tokens(&self) -> TokenCount
Returns checked input plus output tokens.
Trait Implementations§
Source§impl Clone for ModelUsage
impl Clone for ModelUsage
Source§impl Debug for ModelUsage
impl Debug for ModelUsage
Source§impl<'de> Deserialize<'de> for ModelUsage
impl<'de> Deserialize<'de> for ModelUsage
Source§fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>where
D: Deserializer<'de>,
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>where
D: Deserializer<'de>,
impl Eq for ModelUsage
Source§impl JsonSchema for ModelUsage
impl JsonSchema for ModelUsage
Source§fn schema_id() -> Cow<'static, str>
fn schema_id() -> Cow<'static, str>
Source§fn json_schema(generator: &mut SchemaGenerator) -> Schema
fn json_schema(generator: &mut SchemaGenerator) -> Schema
Source§fn inline_schema() -> bool
fn inline_schema() -> bool
$ref keyword. Read more