Documentation
Deep dive into architecture, security, and usage.
Security & Authentication
MagmaTTS employs dynamic Rate Limiting & Tracking mechanisms. Your usage is strictly monitored to prevent unauthorized key sharing or brute-force attacks while remaining fully compatible with mobile networks.
We track incoming IP velocity and deduct quotas in real-time. Excessive concurrent requests will be blocked instantly, returning a 429 Too Many Requests status.
Header Requirement
Authorization: Bearer <YOUR_API_KEY>
Quotas & Rate Limits
Rate Limits
Maximum 5 concurrent requests per second per IP address. Exceeding this returns HTTP 429.
Tier Limits
Basic tier gets 20 requests per 4 hours. Pro tier limits by character count renewing hourly. Unlimited tier has no limits.
Audio Processing Engine
When you submit text, our gateway splits lengthy inputs into logical sentence chunks (up to 350 characters each). These chunks are processed concurrently across our GPU fleet.
Dead silence at the boundaries of each chunk is dynamically trimmed via numpy array analysis, before being seamlessly concatenated back into a single continuous stream. Final output is delivered as standard 22.05kHz 16-bit PCM WAV.