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.

• 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

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

Cam Model Pattern (single word, underscores, hyphens):

1. Priority Sources:

Traditional Pornstar Pattern (multiple words):

1. Priority Sources: '

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

1. Go to Models page
2. Find target model in list
3. Click “Find Images” button next to model name
4. System automatically loads with model information

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

The system displays detected pattern and strategy:

• 🎯 Smart Prioritization: Detected as Cam Model pattern
• 🎯 Smart Prioritization: Detected as Traditional Pornstar pattern

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

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

Images are automatically sorted by:

1. Primary: Estimated file size (largest first)
2. Secondary: Source priority (highest quality first)
3. Tertiary: Aspect ratio compatibility

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

For sites with protection (CloudFlare, age verification):

• Predicts likely image URLs based on naming patterns
• Tests predicted URLs directly
• Bypasses some access restrictions

• 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

• 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

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

• 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

“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

• 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

• 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

• 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

• Click image or “Select & Crop” button
• Automatic download to temp directory
• Direct transfer to cropping interface
• Seamless workflow continuation

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

• Maintains return path throughout workflow
• “Back to Models” returns to previous page
• “Cancel” operations preserve navigation
• Context-aware navigation

• 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

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

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

• Error Logs: Check ../logs/ai-error.log
• License Support: Contact through license portal
• Community Forum: Official Help
• Documentation: Check for updates

• 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