Skip to content

Bedrock Runtime  >  Structures  >  TokenUsage

TokenUsage

Structure Class

TokenUsage dataclass

The tokens used in a message API inference call.

Attributes

cache_details class-attribute instance-attribute
cache_details: list[CacheDetail] | None = None

Detailed breakdown of cache writes by TTL. Empty if no cache creation occurred. Sorted by TTL duration (1h before 5m).

cache_read_input_tokens class-attribute instance-attribute
cache_read_input_tokens: int | None = None

The number of input tokens read from the cache for the request.

cache_write_input_tokens class-attribute instance-attribute
cache_write_input_tokens: int | None = None

The number of input tokens written to the cache for the request.

input_tokens instance-attribute
input_tokens: int

The number of tokens sent in the request to the model.

output_tokens instance-attribute
output_tokens: int

The number of tokens that the model generated for the request.

total_tokens instance-attribute
total_tokens: int

The total of input tokens and tokens generated by the model.