Rate Limits

Learn about Neosantaras Rate Limiting

Our rate limiting is token-based, ensuring a fair and transparent approach to API usage. This system helps maintain service quality for all users by preventing excessive consumption of resources. Limits are enforced on tokens per day and tokens per month (stored in our database). Additional limits on requests per day and per minute are enforced programmatically using Upstash Redis. See Token Credits & Pricing for more details.

Tier Limits

These are the maximum token limits for each plan, tracked in our database.

Tier	Tokens per Day	Tokens per Month	Cost per 1K Tokens
Free	1,500	7,500	Rp 0
Basic	3,000	10,000	Rp 7.50
Standard	10,000	50,000	Rp 6.00
Pro	10,000	1,500,000	Rp 1.49
Enterprise	Custom	Custom	Custom

Response Headers

Every API response includes usage information within the _metadata field. This allows you to track your current consumption against your plan limits directly from your application.

{
  "_metadata": {
    "usage": {
      "daily": {
        "current": 50,
        "limit": 1500, // Example limit for Free tier
        "reset_date": "2025-07-28T00:00:00Z",
        "remaining": 1450
      },
      "monthly": {
        "current": 500,
        "limit": 7500, // Example limit for Free tier
        "reset_date": "2025-08-01T00:00:00Z",
        "remaining": 7000
      }
    },
    "tier": {
      "name": "Free",
      "priority": 1
    }
  }
}

Rate Limit Errors

When your API usage exceeds the allocated rate limit for your plan, the API will return an HTTP Status Code 429: Too Many Requests. The response body will include details about the exceeded limit and when it will reset.

{
  "status": false,
  "creator": "neosantara.xyz",
  "error": {
    "message": "Daily token limit exceeded for your account (1500).",
    "type": "usage_limit_exceeded",
    "code": "user_total_daily_limit_exceeded"
  },
  "usage": {
    "current": 1500,
    "limit": 1500,
    "reset_date": "2025-07-28T00:00:00Z",
    "remaining": 0
  },
  "tier": "Free",
  "timestamp": "2025-07-27T04:10:59Z"
}