42 API Endpoints. 8 Major AI Systems. Industry-First Capabilities.
Everything you need to run a modern photography business - from AI-powered organization to complete e-commerce.
Industry-first capabilities that no competitor offers
Machine learning model predicts which photos your clients are most likely to purchase. Uses 11-feature analysis including technical quality, detected subjects, burst context, and emotional composition.
Prioritize which photos to highlight in galleries
Show clients their best photos first
LightGBM model trained on quality metrics
/api/ai/purchase-prediction/train - Train model on gallery data
/api/ai/purchase-prediction/predict - Get predictions for photos
/api/ai/purchase-prediction/analytics - Gallery-wide analytics
/api/ai/purchase-prediction/recommendations - Top photos to highlight
Automatically detect peak action moments in sports photography - ball contact, jump apex, dynamic poses. Saves 4+ hours per sports event by instantly finding the best shots.
Hand-ball proximity analysis with OpenCV
Peak vertical displacement detection
MediaPipe joint angle analysis
/api/ai/action-detection/detect - Detect action in single photo
/api/ai/action-detection/batch - Process multiple photos
/api/ai/action-detection/gallery - Analyze entire gallery
/api/ai/action-detection/peak-moments - Get top action shots
/api/ai/action-detection/analytics - Action type distribution
Organize 500 photos into perfect albums in 8 seconds. Five intelligent organization strategies using DBSCAN clustering and AI analysis. Saves 4+ hours of manual album creation.
Intelligent time-gap detection (DBSCAN)
Group by detected people/jerseys
Tier photos by quality scores
Group peak action moments
AI-detected themes (portraits, action, etc.)
/api/ai/smart-albums/create - Create albums with strategy
/api/ai/smart-albums/preview - Preview album structure
/api/ai/smart-albums/analytics - Album organization stats
/api/ai/smart-albums/refine - Adjust album parameters
/api/ai/smart-albums/clear - Remove auto-created albums
/api/ai/smart-albums/strategies - List available strategies
AI-generated photo descriptions using advanced vision AI. Four caption styles (descriptive, creative, technical, social media). Subject-aware captions include detected names and jersey numbers. Searchable and accessible.
Factual scene description
Emotional storytelling
Composition analysis
Hashtag-optimized
/api/ai/captions/generate - Generate caption for photo
/api/ai/captions/batch - Generate captions for multiple photos
/api/ai/captions/gallery - Caption entire gallery
/api/ai/captions/search - Search photos by caption keywords
/api/ai/captions/cost-estimate - Calculate caption generation cost
Three-system subject detection: jersey number recognition, facial matching, and automatic person identification. Find all photos of Player #23 or any specific person instantly.
Automatic number recognition on uniforms
Identify people across all photos
Automatic subject identification
/api/subjects/detect - Detect subjects in photo
/api/subjects/batch-detect - Batch subject detection
/api/subjects/list - List all detected subjects
/api/subjects/<id> - Get subject details
/api/subjects/<id> - Update subject name
/api/subjects/<id> - Delete subject
/api/subjects/<id>/photos - All photos of subject
/api/subjects/merge - Merge duplicate subjects
/api/subjects/search - Search subjects by name/jersey
/api/subjects/analytics - Subject appearance stats
/api/subjects/link-photos - Manually link photo to subject
Clients get "Show me MY photos" links. Filter entire gallery by subject name or jersey number. Perfect for sports parents (Player #23's photos) or wedding guests (Sarah's family photos).
/gallery/game/personalized?jersey=23
Best photos of subject shown first
Add to cart directly from personalized view
/gallery/<slug>/personalized?subject=<id> - Personalized gallery view
Everything you need to sell photos online
Session-based cart for guests, database-backed for logged-in customers. Cart transfer on login. Supports multiple photo sizes with price snapshots at add-time.
/api/cart/add - Add photo to cart
/api/cart - Get cart contents
/api/cart/<item_id> - Remove item
/api/cart/clear - Clear entire cart
/api/cart/bulk-add - Add multiple photos
/api/cart/transfer - Transfer guest cart to account
/api/cart/count - Get cart item count
Full payment processing with Stripe Checkout Sessions. Webhook handling for automatic order fulfillment. 10% platform fee, 90% to photographer. Auto-generated purchase numbers (PN-YYYYMMDD-XXXXXX).
/api/stripe/checkout/create-session - Create Stripe checkout
/api/stripe/checkout/success - Success redirect handler
/api/stripe/checkout/cancel - Cancellation handler
/api/stripe/webhook - Webhook for payment events
/api/stripe/config - Get publishable key
Token-based download authentication (no login required for email links). S3 presigned URLs with 1-hour expiration. Download limits (3 per purchase), 7-day access expiration. Complete audit trail.
/api/downloads/purchase/<purchase_number> - Get purchase downloads
/api/downloads/item/<token> - Download photo (token auth)
/api/downloads/history/<purchase_id> - Download history
/api/downloads/extend/<token> - Extend expiration
/api/downloads/reset-limit/<token> - Reset download count
Professional photography workflow management
Automatic burst sequence detection, quality scoring with OpenCV, and intelligent context-aware culling. Reduce 500 photos to top 50 in minutes.
Create public and password-protected galleries. Custom slugs, cover photos, descriptions. Lightbox viewing with keyboard navigation.
Configurable watermarks applied automatically during gallery generation. Original photos protected, watermarked versions for client viewing.
100% MIT/Apache Licensed - Commercial-friendly open source
Join photographers who are saving 4+ hours per shoot with AI-powered workflows
Start Free Trial See Use Cases