Three Rate Limiting Metrics
The Neosantara Gateway separates throughput controls into three independent metrics:- RPM (Requests Per Minute): Total HTTP call volume per minute enforced using a sliding window algorithm.
- ITPM (Input Tokens Per Minute): Prompt token throughput enforced via a token bucket algorithm. Evaluated pre-flight before forwarding to the upstream model.
- OTPM (Output Tokens Per Minute): Generated completion token volume. Settled post-flight after the model finishes producing output.
Throughput Limits by Tier
MCP Gateway Quotas & Limits by Tier
For IDE and agent integrations powered by the Model Context Protocol (MCP), Neosantara enforces dedicated request and summary token limits separate from gateway token throughput:
Each account may provision up to 5 active MCP keys. Learn more in the MCP API Keys guide.
Promotional Model Limits (Free Tier)
For 100% discounted promotional models on the Free tier, a promotional limit of 5 RPM applies. To unlock the full Free tier limit (10 RPM), deposit at least IDR 50,000 via the billing top-up dashboard.Handling Rate Limit Errors (HTTP 429)
When your application exceeds any of the limits, the gateway returns HTTP429 Too Many Requests in standard JSON:
Client-Side Best Practices
- Inspect the
retry-afterheader to determine how many seconds to wait before dispatching the next request. - Implement exponential backoff with randomized jitter in your client network layer.
- For bulk workloads that do not require real-time interactive responses, dispatch requests via Batch Processing which operates outside real-time RPM ceilings.