---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/llm/gemini_generate_content/types/interfaces/GeminiUsageMetadata.md
description: Per-candidate token accounting.
---

# Interface: GeminiUsageMetadata

Defined in: [src/batteries/llm/gemini\_generate\_content/types.ts:229](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/gemini_generate_content/types.ts#L229)

Per-candidate token accounting.

## Properties

| Property                                                                 | Type     | Description                                             | Defined in                                                                                                                                                            |
| ------------------------------------------------------------------------ | -------- | ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  `cachedContentTokenCount?` | `number` | Tokens served from context cache rather than re-billed. | [src/batteries/llm/gemini\_generate\_content/types.ts:239](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/gemini_generate_content/types.ts#L239) |
|  `candidatesTokenCount?`       | `number` | Output tokens across all candidates.                    | [src/batteries/llm/gemini\_generate\_content/types.ts:233](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/gemini_generate_content/types.ts#L233) |
|  `promptTokenCount?`               | `number` | Input tokens billed for the prompt.                     | [src/batteries/llm/gemini\_generate\_content/types.ts:231](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/gemini_generate_content/types.ts#L231) |
|  `thoughtsTokenCount?`           | `number` | Reasoning tokens, when `includeThoughts` is on.         | [src/batteries/llm/gemini\_generate\_content/types.ts:237](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/gemini_generate_content/types.ts#L237) |
|  `totalTokenCount?`                 | `number` | Prompt + candidates.                                    | [src/batteries/llm/gemini\_generate\_content/types.ts:235](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/gemini_generate_content/types.ts#L235) |