ComusThumbz, Videos, Cams and More

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

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

----

==== Date Column ====
  * Shows date and time of each transaction
  * Format: "Jun 30, 14:30" (Month Day, Hour:Minute)
  * Sorted with most recent transactions first

Edit summary