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