Project: /docs/reference/js/_project.yaml Book: /docs/reference/_book.yaml page_type: reference

{% comment %} DO NOT EDIT THIS FILE! This is generated by the JS SDK team, and any local changes will be overwritten. Changes should be made in the source code at https://github.com/firebase/firebase-js-sdk {% endcomment %}

UsageMetadata interface

Usage metadata about a GenerateContentResponse.

Signature:

typescript

export interface UsageMetadata

Properties

Property	Type	Description
cachedContentTokenCount	number	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.
cacheTokensDetails	ModalityTokenCount<!-- -->[]	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.
candidatesTokenCount	number
candidatesTokensDetails	ModalityTokenCount<!-- -->[]
promptTokenCount	number
promptTokensDetails	ModalityTokenCount<!-- -->[]
thoughtsTokenCount	number	The number of tokens used by the model's internal "thinking" process.
toolUsePromptTokenCount	number	The number of tokens used by tools.
toolUsePromptTokensDetails	ModalityTokenCount<!-- -->[]	A list of tokens used by tools, broken down by modality.
totalTokenCount	number

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:

typescript

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:

typescript

cacheTokensDetails?: ModalityTokenCount[];

UsageMetadata.candidatesTokenCount

Signature:

typescript

candidatesTokenCount: number;

UsageMetadata.candidatesTokensDetails

Signature:

typescript

candidatesTokensDetails?: ModalityTokenCount[];

UsageMetadata.promptTokenCount

Signature:

typescript

promptTokenCount: number;

UsageMetadata.promptTokensDetails

Signature:

typescript

promptTokensDetails?: ModalityTokenCount[];

UsageMetadata.thoughtsTokenCount

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

Signature:

typescript

thoughtsTokenCount?: number;

UsageMetadata.toolUsePromptTokenCount

The number of tokens used by tools.

Signature:

typescript

toolUsePromptTokenCount?: number;

UsageMetadata.toolUsePromptTokensDetails

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

Signature:

typescript

toolUsePromptTokensDetails?: ModalityTokenCount[];

UsageMetadata.totalTokenCount

Signature:

typescript

totalTokenCount: number;