User Tools

Site Tools


token_credit_usage_dashboard

This is an old revision of the document!


Table of Contents

Token & Credit Usage Dashboard - Complete User Guide

Recent Updates & New Features Added:

1. Daily Usage Tracking

  • Added $daily_usage = []; array to track daily spending
  • Added daily usage calculation in the analytics loop
  • Shows the last 30 days of usage

2. Daily Usage Graph

  • Visual Chart: 30-day bar chart showing daily spending
  • Smart Display: Shows actual spending amounts when > $0
  • Color Coding: Blue bars for usage days, gray for no usage
  • Tooltips: Hover shows date and amount
  • Layout: Day numbers on top, day names (Mon, Tue, etc.) on bottom

3. Enhanced Analytics

  • Both monthly and daily usage are processed together
  • Monthly graph shows last 12 months
  • Daily graph shows last 30 days consistently (fills in missing days with $0)

4. Visual Improvements

  • Daily bars: Smaller width (15px vs 20px) to fit 30 days
  • Dynamic heights: Bars scale relative to maximum daily usage
  • Responsive design: Adjusts to available data
  • Better spacing: Optimized for readability

5. Key Fixes Applied

  • Fixed switch statement with proper break; statements
  • Corrected redirect URLs (?action= instead of ?error=)
  • Improved CSV download with proper headers and error handling
  • Added missing error cases for better user feedback

The daily usage graph appears right below the monthly usage trend and shows:

  • Date numbers (1-31) at the top
  • Usage bars in the middle (blue for spending, gray for no activity)
  • Dollar amounts below bars (only when > $0)
  • Day names (Mon, Tue, etc.) at the bottom

Welcome to Your Token & Credit Usage Dashboard

This comprehensive dashboard provides detailed insights into your AI service usage, credit balance, and spending patterns. Whether you're new to our platform or a seasoned user, this guide will help you understand every feature and make the most of your account.


Page Overview

The Token & Credit Usage Dashboard is your central hub for monitoring:

  • Account Information: Your license details and account status
  • Financial Overview: Current balance, spending history, and purchase records
  • Usage Statistics: How many tokens and images you've processed
  • Cost Analysis: Detailed breakdowns of your spending patterns
  • Usage Trends: Visual graphs showing your monthly and daily usage patterns

At the top of the page, you'll find several navigation options:

Overview

  • Returns you to the main dashboard view
  • Refreshes all data to current state

Refresh Data

  • Manually updates all information from our servers
  • Use this if you want the most current data
  • Automatically happens every 5 minutes

Download History

  • Downloads your complete transaction history as a CSV file
  • Includes all purchases, usage, and refunds
  • Perfect for accounting or personal record-keeping
  • File name includes date and time: token_usage_history_2025-06-30_14-30-15.csv

Back to Reports

  • Returns you to the main reports section
  • Provides access to other analytical tools

[?] Help

  • Links to detailed documentation
  • Provides additional support resources

Account Overview Section

This section displays your basic account information:

Email

  • The email address associated with your account
  • Used for billing and communication

Domain

  • The website domain registered to your license
  • Shows where your API services are authorized to run

License Type

  • Your current subscription plan or license level
  • Determines your access level and features

Member Since

  • The date you first joined our platform
  • Helps track your account history

Current Balance & Usage Statistics

This critical section shows your financial status and usage metrics:

Current Balance

  • Green Text: Balance above $1.00 (healthy)
  • Red Text: Balance below $1.00 (needs attention)
  • Shows your available credits to 6 decimal places for precision

Total Purchased

  • Lifetime total of all credits you've bought
  • Helps track your overall investment

Total Spent

  • Lifetime total of all credits used for services
  • Shows your cumulative usage costs

API Calls Made

  • Total number of API requests to our services
  • Includes both successful and failed calls

Tokens Used

  • Total AI tokens processed across all services
  • Includes input, output, and cached tokens

Images Processed

  • Total number of images analyzed or generated
  • Counts all image-related AI operations

Credits Used

  • Total credits consumed for all services
  • Should match your “Total Spent” amount

Last Updated

  • Timestamp showing when data was last refreshed
  • Updates automatically every 5 minutes

Estimated Usage Remaining

This predictive section helps you plan your usage based on current balance:

Image Searches

  • Estimated number of images you can process
  • Based on current pricing of $0.0001 per image
  • Example: $10.00 balance = ~100,000 images

AI Input Tokens

  • Estimated tokens for data you send to AI
  • Priced at $0.60 per 1 million tokens
  • These are the prompts and questions you submit

AI Completion Tokens

  • Estimated tokens for AI responses back to you
  • Priced at $1.00 per 1 million tokens
  • These cost more because they require generation

AI Cached Tokens

  • Estimated tokens for previously processed data
  • Priced at $0.075 per 1 million tokens
  • Significant savings for repeated content

Cost Per Usage

  • Shows the exact pricing for bulk usage
  • Helps you understand cost structure
  • All prices are per 1 million tokens or 10,000 images

Low Balance Warning

⚠️ Important Alert System

When your balance drops below $1.00, you'll see a prominent red warning box:

* Flashing Animation: Draws attention to low funds
* Direct Action: “Click here to purchase credits” button
* Prevents Service Interruption: Ensures continuous AI access
* Automatic Detection: Appears automatically when balance is low

Recent Transaction History

This detailed table shows your last 100 transactions:

Date Column

  • Shows date and time of each transaction
  • Format: “Jun 30, 14:30” (Month Day, Hour:Minute)
  • Sorted with most recent transactions first

Type Column

  • Purchase (Green): Credits added to account
  • Usage (Red): Credits spent on services
  • Refund (Blue): Credits returned to account

Service Column

  • ai_images: Image processing services
  • ai_data: Text AI processing
  • ai_data_cached: Cached content processing
  • ai_data_completion: AI response generation

Amount Column

  • Green: Money added (purchases, refunds)
  • Red: Money spent (usage)
  • Shows absolute value (always positive numbers)

Tokens & Images Columns

  • Specific usage metrics for each transaction
  • Helps identify high-usage sessions
  • Useful for optimization planning

Description Column

  • Brief explanation of the transaction
  • May include API endpoint or service details
  • Truncated to 50 characters for table formatting

Usage Analytics

Summary Statistics

Total Transactions

  • Count of all account activity
  • Includes purchases, usage, and refunds

Average per Transaction

  • Your typical spending per API call
  • Calculated as: Total Spent ÷ Total Transactions
  • Helps identify usage patterns

Service Breakdown

  • Image Processing: Total spent on image-related AI
  • AI Text Processing: Total spent on text AI services
  • Combines input, cached, and completion token costs

Monthly Usage Trend (Visual Graph)

This bar chart shows your spending patterns over the last 12 months:

Reading the Graph

  • X-Axis: Month and year (e.g., “Jun 2025”)
  • Y-Axis: Spending amount in dollars
  • Bar Height: Proportional to spending amount
  • Green Bars: Consistent color for all months

Understanding Patterns

  • Tall Bars: High-usage months
  • Short Bars: Low-usage months
  • Missing Bars: Months with no usage
  • Trend Analysis: Spot increasing or decreasing usage

Practical Uses

  • Budget Planning: Predict future costs
  • Usage Optimization: Identify peak usage periods
  • Cost Control: Spot unusual spending spikes

Daily Usage Trend (Visual Graph)

This detailed chart shows your spending for the last 30 days:

Three-Row Layout

Top Row: Day Numbers

  • Shows calendar day (1-31)
  • Helps identify specific dates

Middle Row: Usage Bars

  • Blue Bars: Days with spending
  • Gray Bars: Days with no activity
  • Bar Height: Proportional to daily spending
  • Dollar Amount: Shown below each bar (when > $0)

Bottom Row: Day Names

  • Shows day of week (Mon, Tue, Wed, etc.)
  • Helps identify weekly patterns

Interpreting Daily Patterns

  • Weekday vs Weekend: Compare business vs personal usage
  • Consistent Usage: Regular daily patterns
  • Spike Days: Identify heavy usage sessions
  • Gaps: Days without any AI activity

Hover Information

  • Move mouse over bars for detailed tooltips
  • Shows exact date and spending amount
  • Format: “Jun 30: $1.23”

Quick Actions Panel

Three convenient shortcuts for common tasks:

💳 Purchase Credits

  • Direct link to add funds to your account
  • Essential when balance runs low
  • Secure payment processing

🧪 Test API

  • Access to API testing tools
  • Verify your integration is working
  • Test different endpoints and parameters

📊 Download Report

  • Same as the navigation menu option
  • Export your usage data
  • CSV format for spreadsheet analysis

Understanding Your Data

Real-Time Updates

  • Data refreshes automatically every 5 minutes
  • Manual refresh available anytime
  • “Last Updated” timestamp confirms current data

Precision and Accuracy

  • Currency shown to 6 decimal places
  • Exact token counts provided
  • All data sourced from live API calls

Historical Tracking

  • Complete transaction history maintained
  • Monthly trends for long-term analysis
  • Daily patterns for recent activity

Pricing Structure Explained

Image Processing: $0.0001 per image

  • Cost: $1.00 per 10,000 images
  • Use Cases: Image analysis, generation, classification
  • Efficiency: Bulk processing recommended

AI Input Tokens: $0.60 per 1M tokens

  • What It Is: Text you send to AI (prompts, questions)
  • Cost Control: Shorter prompts cost less
  • Optimization: Clear, concise requests save money

AI Completion Tokens: $1.00 per 1M tokens

  • What It Is: Text AI generates for you (responses, content)
  • Higher Cost: Generation requires more processing
  • Value: High-quality AI responses

AI Cached Tokens: $0.075 per 1M tokens

  • What It Is: Previously processed content reused
  • Savings: 87.5% discount from regular input pricing
  • Benefit: Significant cost reduction for repeated content

New Features Overview

The dashboard includes several enhanced features for better monitoring:

Daily Usage Tracking

  • 30-Day Visual Chart: Bar chart showing daily spending patterns
  • Smart Display: Shows actual spending amounts when greater than $0
  • Color Coding: Blue bars for usage days, gray for no activity
  • Interactive Tooltips: Hover over bars to see exact date and amount
  • Three-Row Layout: Day numbers, usage bars, and day names for easy reading

Enhanced Analytics

  • Combined Processing: Both monthly and daily usage calculated together
  • Consistent Time Frames: Monthly shows last 12 months, daily shows last 30 days
  • Missing Day Handling: Automatically fills in days with no usage as $0
  • Responsive Design: Charts adjust based on available data

Visual Improvements

  • Optimized Bar Sizing: Daily bars are smaller (15px) to fit 30 days comfortably
  • Dynamic Heights: All bars scale relative to maximum usage in their timeframe
  • Better Spacing: Improved readability and organization
  • Pattern Recognition: Easy identification of weekday vs weekend usage patterns

Technical Fixes

  • Improved CSV Download: Proper headers and comprehensive error handling
  • Enhanced Error Messages: Better user feedback for common issues
  • Corrected Navigation: Fixed redirect URLs and switch statement logic
  • Real-Time Updates: Data refreshes every 5 minutes automatically

Troubleshooting Common Issues

Page Won't Load Data

  1. Check your internet connection
  2. Click “Refresh Data” in navigation
  3. Verify your license configuration
  4. Contact support if issues persist

Download Not Working

  1. Ensure you have transaction history
  2. Check browser pop-up blockers
  3. Try different browser
  4. Check downloads folder

Balance Showing Incorrectly

  1. Click “Refresh Data” for current balance
  2. Check recent transactions for updates
  3. Allow 5-10 minutes for payment processing
  4. Contact billing support for discrepancies

Graphs Not Displaying

  1. Ensure you have usage history
  2. Try refreshing the page
  3. Check browser JavaScript is enabled
  4. Wait for data to load completely

Best Practices for Usage Monitoring

Regular Monitoring

  • Check balance weekly or before large projects
  • Review monthly trends for budget planning
  • Monitor daily usage during active periods

Cost Optimization

  • Use cached tokens when possible (87.5% savings)
  • Keep prompts concise but clear
  • Batch similar requests together
  • Monitor image processing volumes

Account Management

  • Set up low balance alerts
  • Download transaction history monthly
  • Track API integration performance
  • Plan credit purchases in advance

Getting Support

Self-Service Options

  • Use the “[?] Help” link for documentation
  • Download transaction history for detailed analysis
  • Try “Refresh Data” for sync issues

Contact Information

  • Technical Issues: API integration problems
  • Billing Questions: Payment and credit inquiries
  • Account Access: License and domain issues

Preparation for Support

  • Have your account email ready
  • Note specific error messages
  • Include relevant transaction IDs
  • Describe steps that led to the issue

Conclusion

💡 Dashboard Benefits

The Token & Credit Usage Dashboard provides comprehensive visibility into your AI service consumption and costs. By understanding each section and regularly monitoring your usage patterns, you can:

* Optimize Costs: Make informed decisions about AI usage
* Plan Budgets: Predict future spending based on trends
* Prevent Interruptions: Maintain adequate credit balance
* Track ROI: Measure the value of your AI investments

Take time to explore each section and familiarize yourself with the data. Regular monitoring will help you maximize the value of your AI services while maintaining cost control.


For additional support or questions about specific features, please use the Help link in the navigation menu or contact our support team.

token_credit_usage_dashboard.1751319888.txt.gz · Last modified: by admin

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki