IMPORTANT: In July 2025, we stopped releasing new versions of KTX modules, and we removed the KTX libraries from the Firebase Android BoM (v34.0.0). If you use KTX APIs from the previously released KTX modules, we recommend that you migrate your app to use KTX APIs from the main modules instead. For details, see the FAQ about this initiative.

UsageMetadata

public final class UsageMetadata

Usage metadata about response(s).

Summary

Public fields
`final Integer`	`candidatesTokenCount` Number of tokens in the response(s).
`final @NonNull List<@NonNull ModalityTokenCount>`	`candidatesTokensDetails` The breakdown, by modality, of how many tokens are consumed by the candidates.
`final int`	`promptTokenCount` Number of tokens in the request.
`final @NonNull List<@NonNull ModalityTokenCount>`	`promptTokensDetails` The breakdown, by modality, of how many tokens are consumed by the prompt.
`final int`	`totalTokenCount` Total number of tokens.

Public constructors
`UsageMetadata( int promptTokenCount, Integer candidatesTokenCount, int totalTokenCount, @NonNull List<@NonNull ModalityTokenCount> promptTokensDetails, @NonNull List<@NonNull ModalityTokenCount> candidatesTokensDetails )`

Public fields

candidatesTokenCount

public final Integer candidatesTokenCount

Number of tokens in the response(s).

candidatesTokensDetails

public final @NonNull List<@NonNull ModalityTokenCount> candidatesTokensDetails

The breakdown, by modality, of how many tokens are consumed by the candidates.

promptTokenCount

public final int promptTokenCount

Number of tokens in the request.

promptTokensDetails

public final @NonNull List<@NonNull ModalityTokenCount> promptTokensDetails

The breakdown, by modality, of how many tokens are consumed by the prompt.

totalTokenCount

public final int totalTokenCount

Total number of tokens.

Public constructors

UsageMetadata

public UsageMetadata(
    int promptTokenCount,
    Integer candidatesTokenCount,
    int totalTokenCount,
    @NonNull List<@NonNull ModalityTokenCount> promptTokensDetails,
    @NonNull List<@NonNull ModalityTokenCount> candidatesTokensDetails
)

Parameters
`int promptTokenCount`	Number of tokens in the request.
`Integer candidatesTokenCount`	Number of tokens in the response(s).
`int totalTokenCount`	Total number of tokens.
`@NonNull List<@NonNull ModalityTokenCount> promptTokensDetails`	The breakdown, by modality, of how many tokens are consumed by the prompt.
`@NonNull List<@NonNull ModalityTokenCount> candidatesTokensDetails`	The breakdown, by modality, of how many tokens are consumed by the candidates.