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.

====== AI Image Selector - Complete Guide ======

===== Overview =====

The AI Image Selector is an advanced image discovery system that automatically finds high-quality model images from multiple databases. It uses smart prioritization, real-time billing through License API, and sophisticated filtering to deliver the best possible images for your models.

===== Key Features =====

* **Multi-Source Image Discovery** - Searches 10+ optimized databases simultaneously
  * **Smart Prioritization** - Adapts search strategy based on model name patterns
  * **License API Integration** - Real-time credit billing and verification
  * **Quality Filtering** - Automatically filters out icons, banners, and low-quality images
  * **Size-Based Sorting** - Orders images by estimated quality and dimensions
  * **One-Click Selection** - Direct integration with cropping interface

===== How It Works =====

==== Smart Prioritization System ====

The system automatically detects model name patterns and adjusts search priorities:

**Cam Model Pattern** (single word, underscores, hyphens):
  - **Priority Sources:**

**Traditional Pornstar Pattern** (multiple words):
  - **Priority Sources:** '

===== Getting Started =====

==== Prerequisites ====

* Valid license with credits for image search
  * Model entry in your database
  * Internet connectivity for source access
  * Proper permissions (Category 3 access)

==== Accessing Image Selector ====

- Go to Models page
  - Find target model in list
  - Click **"Find Images"** button next to model name
  - System automatically loads with model information

===== Using the Interface =====

==== License Status Display ====

The page shows current license information:
  * **✅ Verified License** - Shows license type and credits balance
  * **⚠️ License Warning** - Limited functionality warning
  * **❌ License Error** - Specific error message with troubleshooting

==== Smart Prioritization Info ====

The system displays detected pattern and strategy:
  * **🎯 Smart Prioritization: Detected as Cam Model pattern**
  * **🎯 Smart Prioritization: Detected as Traditional Pornstar pattern**

==== Search Process ====

- **Step 1:** Pattern detection and source prioritization
  - **Step 2:** Parallel searches across optimized sources
  - **Step 3:** Early termination when sufficient images found (20 target)
  - **Step 4:** Duplicate removal and quality filtering
  - **Step 5:** Size estimation and intelligent sorting

===== Image Results =====

==== Understanding Image Cards ====

Each image displays:
  * **Preview** - 200px height thumbnail with proper aspect ratio
  * **Source Label** - Where the image was found with quality indicator
  * **Dimensions** - Width × Height in pixels
  * **File Size** - Estimated size in KB/MB
  * **Select Button** - Direct link to cropping interface

==== Quality Indicators ====

==== Sorting Logic ====

Images are automatically sorted by:
  - **Primary:** Estimated file size (largest first)
  - **Secondary:** Source priority (highest quality first)
  - **Tertiary:** Aspect ratio compatibility

===== Advanced Features =====

==== Enhanced Filtering ====

The system automatically removes:
  * **Icons and buttons** - UI elements, social media icons
  * **Banners and ads** - Promotional content
  * **PNG files** - From sources known for icon usage
  * **Generic images** - Default profiles, placeholders
  * **Social media graphics** - Instagram, Twitter, Facebook icons

==== URL Prediction ====

For sites with protection (CloudFlare, age verification):
  * Predicts likely image URLs based on naming patterns
  * Tests predicted URLs directly
  * Bypasses some access restrictions

==== Sequential Testing ====

* Tests ''model_name.jpg'', ''model_name2.jpg'', ''model_name3.jpg''
  * Stops at first missing image (efficient)
  * Finds numbered image series automatically
  * Reduces unnecessary network requests

===== Cost Management =====

==== Pricing Structure ====

* **Image Search Cost:** $0.0001 per image found
  * **Bulk Rate:** $1.00 per 10,000 images
  * **Real-time Billing:** Credits deducted immediately
  * **No Hidden Fees:** Only pay for images actually found

==== Cost Display ====

The interface shows:
  * **Pre-search:** Estimated cost based on typical results
  * **Post-search:** Actual cost for images found
  * **Balance Update:** Remaining credits after search
  * **Cost Breakdown:** Per-image cost calculation

==== Credit Management ====

* **Balance Check:** Automatic verification before search
  * **Insufficient Credits:** Clear error message with requirements
  * **Low Balance Warning:** Alerts when credits below $1.00
  * **Refresh Button:** Update balance display manually

===== Troubleshooting =====

==== Common Issues ====

**"No images found"**
  * Try variations of model name (with/without spaces, underscores)
  * Check spelling and common aliases
  * Some models may not be in public databases
  * Use manual upload as alternative

**"Insufficient credits"**
  * Check current balance in license info
  * Add credits through license portal
  * Estimated cost shown in error message
  * Contact support for billing issues

**"License API errors"**
  * Verify license configuration
  * Check internet connectivity
  * Try refreshing the page
  * Contact support if persistent

**"Images won't load"**
  * Some sources may block direct linking
  * Try different images from same search
  * Check browser console for errors
  * Network connectivity issues

==== Error Messages ====

===== Best Practices =====

==== Optimizing Results ====

* **Use correct model names** - Match how they're known online
  * **Try common variations** - Stage name vs real name
  * **Check aliases** - Different spellings or formats
  * **Monitor costs** - Track credit usage patterns

==== Image Selection ====

* **Choose largest images** - Better quality for cropping
  * **Prefer professional sources** - studio sites
  * **Check aspect ratios** - Match your requirements
  * **Test image loading** - Ensure image loads properly

==== Credit Management ====

* **Monitor balance regularly** - Check before large batches
  * **Use refresh button** - Update balance display
  * **Plan batch processing** - Budget credits for multiple models
  * **Track usage patterns** - Understand typical costs

===== Integration Features =====

==== Direct Cropping Integration ====

* Click image or **"Select & Crop"** button
  * Automatic download to temp directory
  * Direct transfer to cropping interface
  * Seamless workflow continuation

==== Batch Processing Support ====

* Process multiple models sequentially
  * **"Save Cropped & Next"** in crop interface
  * Automatic progression to next unprocessed model
  * Efficient for large model databases

==== Return URL Handling ====

* Maintains return path throughout workflow
  * **"Back to Models"** returns to previous page
  * **"Cancel"** operations preserve navigation
  * Context-aware navigation

===== Technical Details =====

==== Performance Optimizations ====

* **Multi-threaded requests** - Parallel source fetching
  * **Early termination** - Stops at 20 quality images
  * **Smart caching** - 1-hour result cache
  * **Timeout management** - 10-second per-source limits

==== Security Features ====

* **User-agent rotation** - Avoid bot detection
  * **Referer handling** - Proper source attribution
  * **SSL verification** - Secure connections
  * **Access control** - IP and permission checking

==== Error Handling ====

* **Graceful degradation** - Continue if some sources fail
  * **Detailed logging** - Full debug information
  * **User feedback** - Clear error messages
  * **Automatic retry** - For transient failures

===== Support Resources =====

==== Getting Help ====

* **Error Logs:** Check ''../logs/ai-error.log''
  * **License Support:** Contact through license portal
  * **Community Forum:** [[https://www.comusthumbz.com/forums/|Official Help]]
  * **Documentation:** Check for updates

==== Monitoring and Debugging ====

* **Real-time Logs:** Monitor search progress
  * **Network Tab:** Browser developer tools
  * **Credit History:** License portal billing section
  * **Performance Metrics:** Source response times

---

//Last updated: 2025-06-30//

Edit summary