Rate Limits & Quotas

Understand usage limits, spending controls, and quota management.

Persly uses a credit-based billing system with spending controls to help you manage costs.

Tiers

Free Tier

Every new organization receives $5.00 in free credits upon creation. No credit card required.

• Credits are deducted per request based on the model used
• When credits are exhausted, API requests return 429 with quota_exceeded
• Free credits do not expire

Production Tier

After setting up payment via Stripe, your organization moves to the Production tier.

• Usage is billed monthly through Stripe
• A spending limit (hard_limit_usd) controls maximum monthly spend (default: $100)
• When the spending limit is reached, API requests return 429 with spending_limit_exceeded

Spending Limit

The spending limit prevents unexpected charges. You can adjust it in the dashboard.

When you reach 80% of your spending limit, you'll receive an email alert. When you reach 100%, API requests are blocked until the next billing cycle or you increase the limit.

Handling 429 Responses

{
  "error": {
    "message": "You exceeded your current quota. Please add a payment method to continue.",
    "type": "insufficient_quota",
    "code": "quota_exceeded",
    "param": null
  }
}

{
  "error": {
    "message": "You have exceeded your spending limit. Please increase your limit in settings.",
    "type": "rate_limit_error",
    "code": "spending_limit_exceeded",
    "param": null
  }
}

Cost Per Request

Monitoring Usage

Track your spending and usage in real time at platform.persly.ai:

• View usage by endpoint, model, and date range
• Monitor spending against your limits
• Download usage logs for billing reconciliation