Documentation
import sportyvision # Initialize the detection client client = sportyvision.Client(api_key='your_api_key') # Detect game outcome from image result = client.detect( image_url='https://example.com/game-screen.png', game_type='aviator' ) print(f"Outcome: {result.outcome}") print(f"Confidence: {result.confidence}%") print(f"Timestamp: {result.detected_at}") # Subscribe to real-time detection stream for detection in client.stream(game_id='12345'): print(f"Live result: {detection.outcome}")Frequently Asked Questions
How do I get started with the SportyVision API?
Sign in to your account and navigate to the API settings to generate your unique API key. Install the SDK using pip install sportyvision or npm install sportyvision-js. Use the quick start code example above to make your first detection request. Full authentication and setup instructions are available in our integration guide.
What image formats and resolutions are supported?
SportyVision supports JPEG, PNG, and WebP image formats. Minimum resolution is 640x480 pixels, with optimal results at 1920x1080 or higher. Images can be submitted via direct upload, URL reference, or real-time stream. The detection engine automatically handles scaling and preprocessing to ensure accurate outcome recognition across different screen captures.
How accurate is the visual detection system?
Our detection engine achieves 99.2% accuracy on clear game outcome screens under normal conditions. Each detection includes a confidence score from 0-100%. Results with confidence above 95% are considered highly reliable. The system continuously learns from validated outcomes to improve accuracy over time and adapts to UI changes in supported games.
What games and bet types are currently supported?
SportyVision currently supports Aviator, Crash, Dice, and Mines games on the Sportybet platform. We detect final outcomes, multipliers, crash points, and winning patterns. Support for additional games including Roulette, Blackjack, and virtual sports is in active development. Check our product roadmap for upcoming game integrations.
Can I access historical detection data?
Yes, all detection results are stored and accessible through the Game History dashboard and API endpoints. You can query by date range, game type, outcome value, or confidence threshold. Historical data is retained for 90 days on the free tier and up to 2 years on premium plans. Export options include JSON, CSV, and direct database integration.
What are the API rate limits and pricing tiers?
The free tier includes 1,000 detections per month with a rate limit of 10 requests per minute. Standard plan offers 25,000 detections monthly at 60 requests per minute. Pro and Enterprise tiers provide unlimited detections with dedicated infrastructure. Visit our pricing page for detailed tier comparisons and volume discounts for high-frequency detection workflows.
How do I handle detection errors and retries?
The API returns standard HTTP status codes and detailed error messages. Common errors include invalid image format (400), authentication failure (401), and rate limit exceeded (429). Implement exponential backoff for retry logic, starting with 1 second delay. The SDK includes built-in retry mechanisms with configurable attempts and timeout settings.
Is there webhook support for real-time notifications?
Yes, configure webhooks in your account settings to receive instant notifications when detections complete. Webhooks deliver JSON payloads containing outcome data, confidence scores, and metadata. You can filter notifications by game type, confidence threshold, or specific outcome values. Webhook endpoints must respond within 5 seconds and support HTTPS with valid certificates.