Differences

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

--- ai_image_selector [2025/06/30 22:27] – created admin
+++ ai_image_selector [2025/06/30 22:28] (current) – removed 207.241.225.134
@@ Line 1: / Line 1: @@
-====== 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 ====
-^ Label ^ Meaning ^ Quality Level ^
-| 🎨 HIGH QUALITY | Excellent |
-| ⭐ COMPREHENSIVE | Very Good |
-| 📚 DATABASE | Good |
-| 🎬 STUDIO | Professional source | Very Good |
-| 🌸 ASIAN | Good |
-==== 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 ====
-^ Error ^ Cause ^ Solution ^
-| License configuration invalid | License settings wrong | Check config files |
-| API request failed | Network/server issue | Retry or contact support |
-| Insufficient credits for image search | Low balance | Add credits to account |
-| Model not found | Invalid model ID | Check model exists |
-| Failed to download image | Source blocking | Try different image |
-===== 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//