---
title: "Usage"
---

Token usage information for the response


## Fields

| Field                                                                                      | Type                                                                                       | Required                                                                                   | Description                                                                                | Example                                                                                    |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
| `input_tokens`                                                                             | *int*                                                                                      | :heavy_check_mark:                                                                         | N/A                                                                                        |                                                                                            |
| `input_tokens_details`                                                                     | [components.InputTokensDetails](../components/inputtokensdetails.mdx)                       | :heavy_check_mark:                                                                         | N/A                                                                                        |                                                                                            |
| `output_tokens`                                                                            | *int*                                                                                      | :heavy_check_mark:                                                                         | N/A                                                                                        |                                                                                            |
| `output_tokens_details`                                                                    | [components.OutputTokensDetails](../components/outputtokensdetails.mdx)                     | :heavy_check_mark:                                                                         | N/A                                                                                        |                                                                                            |
| `total_tokens`                                                                             | *int*                                                                                      | :heavy_check_mark:                                                                         | N/A                                                                                        |                                                                                            |
| `cost`                                                                                     | *OptionalNullable[float]*                                                                  | :heavy_minus_sign:                                                                         | Cost of the completion                                                                     |                                                                                            |
| `cost_details`                                                                             | [Optional[components.UsageCostDetails]](../components/usagecostdetails.mdx)                 | :heavy_minus_sign:                                                                         | N/A                                                                                        |                                                                                            |
| `is_byok`                                                                                  | *Optional[bool]*                                                                           | :heavy_minus_sign:                                                                         | Whether a request was made using a Bring Your Own Key configuration                        |                                                                                            |
| `server_tool_use_details`                                                                  | [OptionalNullable[components.ServerToolUseDetails]](../components/servertoolusedetails.mdx) | :heavy_minus_sign:                                                                         | Usage for server-side tool execution (e.g., web search)                                    | \{<br/>"tool_calls_executed": 2,<br/>"tool_calls_requested": 2,<br/>"web_search_requests": 2<br/>} |