Rate Limits

Free Tier (Yadda Ipsum)

No API key required. Returns static Yadda Ipsum text in any template structure.

• 1,000 requests per day per IP address
• No monthly cap
• No authentication needed

This is the gateway — build against the JSON structure for free.

API Tiers

How Billing Works

• Each call to /v1/generate with a topic or tone counts as 1 generation
• Yadda Ipsum requests (no topic/tone) are free and unlimited (within IP limits)
• Cached responses are served faster but still count against your quota

Exceeding Limits

When you hit your limit, the API returns a 429 status:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "You've used all 500 generations for this month. Upgrade to Starter for 10,000/month at $15/mo.",
    "retry_after": 1711929600
  }
}

The retry_after field is a Unix timestamp indicating when your quota resets (first of next month).