# usage

The llm usage command displays the coin usage for Large Language Model (LLM) operations in your project. This command provides detailed information such as total coins used, remaining coins, usage per key, model, and token.

## Usage

```
cldkctl llm usage [flags]
```

## Aliases

```
usage, u
```

## Steps

Follow the steps below to run and view the result of this command:

1. Run the following command in your terminal:

```
cldkctl llm usage
```

2. The terminal displays the detailed coin usage report for your project, including daily spend, total usage, and token details.

<figure><img src="/files/NqYwv47FnU5lA7ASwwql" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="198.16668701171875">Column</th><th>Description</th></tr></thead><tbody><tr><td>LLM Coin Usage</td><td>A summary of total coin usage for LLM operations within the project.</td></tr><tr><td>Daily Spend</td><td>The amount of coins spent within the current day.</td></tr><tr><td>Teams</td><td>The name of the team associated with the project.</td></tr><tr><td>Team ID</td><td>The unique identifier of the team.</td></tr><tr><td>Total Spend</td><td>The total number of coins used in the project.</td></tr><tr><td>Total Token</td><td>The total number of tokens processed by all operations.</td></tr><tr><td>LLM Usage Keys</td><td>A breakdown of usage based on API keys.</td></tr><tr><td>API Key</td><td>The key identifier associated with LLM operations.</td></tr><tr><td>Key Alias</td><td>The alias name assigned to the key.</td></tr><tr><td>Key Name</td><td>The label given to identify the key.</td></tr><tr><td>Total Spend</td><td>The total number of coins spent by this key.</td></tr><tr><td>LLM Usage Model</td><td>A breakdown of usage based on LLM models.</td></tr><tr><td>Model</td><td>The name of the LLM model used.</td></tr><tr><td>Total Spend</td><td>The total coins spent for operations on this model.</td></tr><tr><td>LLM Usage Token</td><td>A breakdown of token usage details.</td></tr><tr><td>Model</td><td>The LLM model name associated with the token usage.</td></tr><tr><td>Token</td><td>The identifier of the token used in the request.</td></tr><tr><td>Total Input Token</td><td>The total number of input tokens consumed.</td></tr><tr><td>Total Output Token</td><td>The total number of output tokens generated.</td></tr></tbody></table>

## Flags

{% hint style="info" %}
This command supports [global flags](/guidance-for-individual/cloudeka-api-list/global-flags.md). Refer to the Global Flags section for details.
{% endhint %}

| Flag       | Description                     |
| ---------- | ------------------------------- |
| -h, --help | Help for the llm usage command. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudeka.ai/guidance-for-individual/cloudeka-api-list/command-reference/cldkctl-llm/usage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
