---
title: "Usage"
---

Token usage information for the response


## Fields

| Field                                                                      | Type                                                                       | Required                                                                   | Description                                                                |
| -------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| `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        |