UsageMetadata interface

Usage metadata about a GenerateContentResponse.

Signature:

export interface UsageMetadata 

Properties

UsageMetadata.cachedContentTokenCount

The number of tokens in the prompt that were served from the cache. If implicit caching is not active or no content was cached, this will be 0.

Signature:

cachedContentTokenCount?: number;

UsageMetadata.cacheTokensDetails

Detailed breakdown of the cached tokens by modality (for example, text or image). This list provides granular insight into which parts of the content were cached.

Signature:

cacheTokensDetails?: ModalityTokenCount[];

UsageMetadata.candidatesTokenCount

Signature:

candidatesTokenCount: number;

UsageMetadata.candidatesTokensDetails

Signature:

candidatesTokensDetails?: ModalityTokenCount[];

UsageMetadata.promptTokenCount

Signature:

promptTokenCount: number;

UsageMetadata.promptTokensDetails

Signature:

promptTokensDetails?: ModalityTokenCount[];

UsageMetadata.thoughtsTokenCount

The number of tokens used by the model's internal "thinking" process.

Signature:

thoughtsTokenCount?: number;

UsageMetadata.toolUsePromptTokenCount

The number of tokens used by tools.

Signature:

toolUsePromptTokenCount?: number;

UsageMetadata.toolUsePromptTokensDetails

A list of tokens used by tools, broken down by modality.

Signature:

toolUsePromptTokensDetails?: ModalityTokenCount[];

UsageMetadata.totalTokenCount

Signature:

totalTokenCount: number;