What This Page Does

This page shows you how many credits you have left in your ComusThumbz account and how you've used them. Credits are like money in your account that get used up when AI features process images or enrich your content. You can see your balance, check your spending history, and purchase more credits when you're running low.

[Screenshot: token-usage-main-interface]

How to Get Here

Navigate to Admin Panel > Reports > Token Usage

Understanding the Page

When you open this page, you'll see several cards showing different information about your credit usage.

Account Overview Section

Shows basic information about your ComusThumbz account, including your email address, license type (like Pro or Enterprise), your registered domain, and when you first created your account.

Balance & Statistics Section

This is the most important section. It shows:

• Current Balance -- How much credit you have left (shown in green if healthy, red if low)
• Tokens Used -- How many AI tokens you've consumed
• Credits Used -- Total amount spent on AI features
• API Calls Made -- Number of times AI features were used
• Images Processed -- How many images have been processed
• Last Updated -- When this information was last refreshed

Current Pricing Section

Shows how much each AI feature costs, so you can understand where your credits are going. Prices are shown per 10,000 images or per 1 million tokens.

Estimated Usage Remaining

Based on your current balance, this shows approximately how many more images or tokens you can process before needing to add credits.

Transaction History

A detailed list of every time credits were added to or used from your account, showing the date, what type of transaction it was, and how much was involved.

Common Tasks

How to Check Your Credit Balance

1. Navigate to Admin Panel > Reports > Token Usage.
2. Look at the Current Balance number in the statistics section.
3. If the number is green, you have a healthy balance.
4. If the number is red and there's a flashing warning banner, you need to add credits soon.

[Screenshot: token-usage-balance-stats]

How to See What's Using Your Credits

1. Scroll down to the Transaction History table.
2. Look at the Service column to see which features used credits.
3. Check the Amount column to see how much each action cost.
4. Use the Previous and Next buttons to browse through older transactions if needed.

How to Refresh Your Balance

If you just purchased more credits or want to see the latest information:

1. Click the Refresh Data button at the top of the page.
2. Wait a few seconds while the page updates.
3. You'll see a green success message when the refresh is complete.
4. Your new balance will be displayed.

[Screenshot: token-usage-navigation]

How to Download Your Transaction History

If you want to keep records or analyze your spending in Excel:

1. Click the Download History button at the top of the page.
2. A CSV file will download automatically to your computer.
3. Open the file in Excel, Google Sheets, or any spreadsheet program.
4. The file contains all your transactions, not just what's shown on the current page.

How to Purchase More Credits

When you see the red warning banner saying your balance is low:

1. Click the Click here to purchase credits link in the warning banner.
2. You'll be taken to the ComusThumbz purchase page.
3. Complete your purchase there.
4. Return to this page and click Refresh Data to see your updated balance.

Filters and Search

This page doesn't have search or filter options. All transactions are shown in order from newest to oldest, with 300 transactions per page.

Understanding Transaction Types

When you look at your transaction history, you'll see different colored badges showing the type of transaction:

Understanding the Pricing Table

The pricing table shows how much different AI features cost:

View Modes

This page only has one view mode. The transaction history is always shown as a table.

Navigation Buttons

Tips for New Users

Troubleshooting

My balance isn't updating after I purchased credits

What you see: Your balance still shows the old amount even though you bought more credits.

How to fix it:

1. Click the Refresh Data button at the top of the page.
2. Wait for the success message to appear.
3. If your balance still doesn't update, wait a few minutes (the purchase might still be processing) and click Refresh Data again.
4. If the problem continues, contact ComusThumbz support with your purchase confirmation.

The page shows an error about being unable to load data

What you see: Instead of your account information, you see an error message saying "Unable to Load Account Data."

How to fix it:

1. Click the Retry Loading Data button shown on the error screen.
2. If that doesn't work, check your internet connection.
3. Make sure your license is active and hasn't expired.
4. Contact your system administrator to verify the license configuration in the settings file.

I see a warning about low balance but I still have credits

What you see: A red flashing banner appears even though your balance isn't zero.

How to fix it:
The warning appears when your balance drops below $1.00. This is intentional to give you advance notice. Add more credits when convenient to avoid running out completely.

The transaction history is empty

What you see: The table shows "No transaction history available."

How to fix it:

1. This is normal if you just activated your license and haven't used any AI features yet.
2. Try clicking Refresh Data to check for new transactions.
3. Once you start using AI-powered features like image processing, transactions will appear here.

The download button doesn't work

What you see: When you click Download History, nothing happens or you see an error.

How to fix it:

1. Check if there's a message saying "Download disabled in demo mode" -- if so, this is expected and you'll need to contact your administrator.
2. If you see "No transaction history available to download," you don't have any transactions yet.
3. For other errors, try clicking Refresh Data first, then try downloading again.

Pricing or balance seems outdated

What you see: The numbers don't seem current or match what you expect.

How to fix it:

1. Look for the "Last Updated" timestamp to see when the data was retrieved.
2. Click Refresh Data to get the latest information.
3. If specific pricing seems wrong, click Update Pricing to refresh just the pricing information.
4. The page caches data for up to 10 minutes to reduce server load, so slight delays are normal.

Related Pages

Auto-Refresh Feature

What "Tokens" and "Credits" Mean

Credits are the currency in your ComusThumbz account. Think of them like dollars -- they're what you purchase and spend.

Tokens are a measurement of how much AI processing happened. Different AI tasks use different amounts of tokens, and each token costs a tiny fraction of a credit. You don't need to understand tokens in detail -- just know that more complex AI tasks use more tokens and therefore more credits.

Images Processed is a simple count of how many images the AI features have handled for you.

Understanding the Estimated Usage Section

The Estimated Usage Remaining card shows you approximately how much more you can do with your current balance:

• Image Searches -- How many more images you can process
• AI Input Tokens -- How much more text the AI can read
• AI Completion Tokens -- How much more text the AI can write
• AI Cached Tokens -- How much more cached processing you can do

Page Behavior Notes

• The page loads quickly because it stores (caches) recently fetched data.
• Pricing information is stored for 5 minutes before being refreshed.
• Transaction history is stored for 1 hour before being refreshed.
• You can force an immediate refresh using the Refresh Data button anytime.
• If you see "Cached" in the footer, the data came from storage. If you see "Live," it was just fetched from the server.