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
Navigation Menu
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:
- 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
- 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
💡 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.