Package com.google.genai.types

Class GenerateContentResponseUsageMetadata

java.lang.Object
com.google.genai.JsonSerializable
com.google.genai.types.GenerateContentResponseUsageMetadata
public abstract class GenerateContentResponseUsageMetadata extends JsonSerializable
Usage metadata about the content generation request and response. This message provides a detailed breakdown of token usage and other relevant metrics. This data type is not supported in Gemini API.

  • Constructor Details

    • GenerateContentResponseUsageMetadata

      public GenerateContentResponseUsageMetadata()

  • Method Details

    • cacheTokensDetails

      public abstract Optional<List<ModalityTokenCount>> cacheTokensDetails()
      Output only. A detailed breakdown of the token count for each modality in the cached content.

    • cachedContentTokenCount

      public abstract Optional<Integer> cachedContentTokenCount()
      Output only. The number of tokens in the cached content that was used for this request.

    • candidatesTokenCount

      public abstract Optional<Integer> candidatesTokenCount()
      The total number of tokens in the generated candidates.

    • candidatesTokensDetails

      public abstract Optional<List<ModalityTokenCount>> candidatesTokensDetails()
      Output only. A detailed breakdown of the token count for each modality in the generated candidates.

    • promptTokenCount

      public abstract Optional<Integer> promptTokenCount()
      The total number of tokens in the prompt. This includes any text, images, or other media provided in the request. When `cached_content` is set, this also includes the number of tokens in the cached content.

    • promptTokensDetails

      public abstract Optional<List<ModalityTokenCount>> promptTokensDetails()
      Output only. A detailed breakdown of the token count for each modality in the prompt.

    • thoughtsTokenCount

      public abstract Optional<Integer> thoughtsTokenCount()
      Output only. The number of tokens that were part of the model's generated "thoughts" output, if applicable.

    • toolUsePromptTokenCount

      public abstract Optional<Integer> toolUsePromptTokenCount()
      Output only. The number of tokens in the results from tool executions, which are provided back to the model as input, if applicable.

    • toolUsePromptTokensDetails

      public abstract Optional<List<ModalityTokenCount>> toolUsePromptTokensDetails()
      Output only. A detailed breakdown by modality of the token counts from the results of tool executions, which are provided back to the model as input.

    • totalTokenCount

      public abstract Optional<Integer> totalTokenCount()
      The total number of tokens for the entire request. This is the sum of `prompt_token_count`, `candidates_token_count`, `tool_use_prompt_token_count`, and `thoughts_token_count`.

    • trafficType

      public abstract Optional<TrafficType> trafficType()
      Output only. The traffic type for this request.

    • builder

      public static GenerateContentResponseUsageMetadata.Builder builder()
      Instantiates a builder for GenerateContentResponseUsageMetadata.

    • toBuilder

      public abstract GenerateContentResponseUsageMetadata.Builder toBuilder()
      Creates a builder with the same values as this instance.

    • fromJson

      public static GenerateContentResponseUsageMetadata fromJson(String jsonString)
      Deserializes a JSON string to a GenerateContentResponseUsageMetadata object.