Method: Anthropic::Models::Message#usage

Defined in:
lib/anthropic/models/message.rb

#usage ⇒ Anthropic::Models::Usage

Billing and rate-limit usage.

Anthropic's API bills and rate-limits by token counts, as tokens represent the underlying cost to our systems.

Under the hood, the API transforms requests into a format suitable for the model. The model's output then goes through a parsing stage before becoming an API response. As a result, the token counts in usage will not match one-to-one with the exact visible content of an API request or response.

For example, output_tokens will be non-zero, even for an empty string response from Claude.

Total input tokens in a request is the summation of input_tokens, cache_creation_input_tokens, and cache_read_input_tokens.

Returns:



137
 
# File 'lib/anthropic/models/message.rb', line 137

required :usage, -> { Anthropic::Usage }