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
MagmaTTS guarantees extreme low latencies. Because of this, the API endpoint (/v1/tts) supports a strictly enforced maximum of 350 characters per request.
Clients are required to split lengthy inputs into logical sentence chunks (up to 350 characters each). These chunks should be requested sequentially or concurrently by the client side application. This architectural requirement prevents heavy queue blocking on our GPU fleets, meaning output is always delivered instantly as standard 22.05kHz 16-bit PCM WAV.