Differences

This shows you the differences between two versions of the page.

--- token_credit_usage_dashboard [2025/06/30 21:35] – [Type Column] admin
+++ token_credit_usage_dashboard [2025/07/06 11:05] (current) – removed 20.171.207.151
@@ Line 1: / Line 1: @@
-====== **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:
-==== 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 ====
-<color green>Green Text</color>: Balance above $1.00 (healthy)
-<color red>Red Text</color>: 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 =====
-<WRAP center round important 60%>
-⚠️ Important Alert System
-</WRAP>
-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 ====
-<color green>Purchase</color> (Green): Credits added to account
-<color red>Usage</color> (Red): Credits spent on services
-<color blue>Refund</color> (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 ====
-<color green>Green</color>: Money added (purchases, refunds)
-<color red>Red</color>: 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
-<color green>Green Bars</color>: 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
-<color blue>Blue Bars</color>: Days with spending
-<color #999>Gray Bars</color>: 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 =====
-<WRAP center round tip 80%>
-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
-</WRAP>
-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 ====
-  * **<color green>Green Text</color>**: Balance above $1.00 (healthy)
-  * **<color red>Red Text</color>**: 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
-----
-===== 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