User Tools

Site Tools


token_credit_usage_dashboard

This is an old revision of the document!


Table of Contents

**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

This gives you a comprehensive view of both long-term trends (monthly) and recent activity patterns (daily).

Token & Credit Usage Dashboard - Complete User Guide

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

Troubleshooting Common Issues

Page Won't Load Data

Check your internet connection Click “Refresh Data” in navigation Verify your license configuration Contact support if issues persist

Download Not Working

Ensure you have transaction history Check browser pop-up blockers Try different browser Check downloads folder

Balance Showing Incorrectly

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

Graphs Not Displaying

Ensure you have usage history Try refreshing the page Check browser JavaScript is enabled 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

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.

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

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

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki