Differences

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

--- token_credit_usage_dashboard [2025/06/30 21:44] – created admin
+++ token_credit_usage_dashboard [2025/07/06 11:05] (current) – removed 20.171.207.151
@@ Line 1: / Line 1: @@
-====== Token & Credit Usage Dashboard - Complete User Guide ======
-<WRAP center round info 90%>
-**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
-</WRAP>
-===== 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 =====
-> **⚠️ 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 ====
-  * **<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
-----
-===== 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.//