On-demand usage allows you to exceed your plan’s included request limits. Usage is billed in arrears, and you can set spending limits to control costs.
Overview
The Spending page (/dashboard/spending) allows you to:
- Enable or disable on-demand usage
- Set monthly spending limits
- Monitor current on-demand usage
- View billing information
On-Demand Usage
How It Works
On-demand usage lets you make requests beyond your plan’s included monthly limits:- Enable On-Demand: Toggle on-demand usage in the Spending page
- Use Beyond Limits: Make requests that exceed your plan’s included quota
- Billed in Arrears: You’re charged for overage usage at the end of the billing period
- Automatic Billing: Charges are automatically added to your next invoice
When to Use On-Demand
On-demand usage is recommended when:- You have variable traffic that occasionally exceeds your plan limits
- You want flexibility without upgrading to a higher tier
- You need to handle traffic spikes without service interruption
Billing Model
- Pay After Use: Charges appear on your next invoice
- Per-Request Pricing: You’re charged for each request beyond your included limit
- No Upfront Cost: Only pay for what you use
Spending Limits
Setting Limits
You can set monthly spending limits to control costs:- Enable On-Demand: Turn on on-demand usage first
- Set Limit: Enter a dollar amount (minimum 10,000)
- Save: Your limit is enforced immediately
Limit Enforcement
Unlimited Option
You can set your limit to “Unlimited” (effectively $10,000/month) if you want maximum flexibility without a hard cap.Current Usage Tracking
The dashboard shows:- Current Month’s Overage: How much you’ve spent on on-demand usage this month
- Limit Progress: Visual progress bar showing usage against your limit
- Real-Time Updates: Usage updates as requests are processed
Plan Comparison
| Plan | Included Requests | On-Demand Available | Recommended For |
|---|---|---|---|
| Free | 10,000/month | No | Getting started, testing |
| Pro | 100,000/month | Yes | Production workloads |
| Scale | 1M/month (soft limit) | Yes | High-volume applications |
Managing Spending Limits
Best Practices
- Start Conservative: Set a lower limit initially and increase as needed
- Monitor Usage: Regularly check your on-demand spending
- Set Alerts: Monitor your usage to avoid surprises
- Plan for Growth: Increase limits before you approach them
Updating Limits
You can update your spending limit at any time:- Navigate to Settings → Spending
- Enter your new limit amount
- Click “Save Limits”
- Changes take effect immediately
Viewing Current Usage
The Spending page displays:- Current Plan: Your active subscription tier
- On-Demand Status: Whether on-demand is enabled
- Current Month’s Overage: Spending this billing period
- Limit Progress: Visual indicator of usage vs. limit
Billing Details
Invoice Details
On-demand usage charges appear on your monthly invoice as:- Base Subscription: Your plan’s monthly fee
- Overage Charges: Additional charges for on-demand usage
- Total: Combined charges for the billing period
Payment Methods
All billing is handled through Stripe:- Automatic Billing: Charges are automatically processed
- Payment Methods: Manage payment methods in Billing & Invoices
- Invoices: View and download invoices from the billing page
Troubleshooting
Requests are being blocked even though I have on-demand enabled
Requests are being blocked even though I have on-demand enabled
Possible Causes:
- You’ve exceeded your spending limit
- On-demand usage is disabled
- Your payment method needs attention
- Check your current spending vs. limit on the Spending page
- Verify on-demand is enabled
- Check your billing status in Billing & Invoices
- Increase your spending limit if needed
How do I disable on-demand usage?
How do I disable on-demand usage?
Navigate to Settings → Spending and toggle off “On-Demand Usage”. Your included plan limits will still apply, but you won’t be able to exceed them.
Can I set a limit lower than my current usage?
Can I set a limit lower than my current usage?
Yes, but be aware that if your current usage already exceeds the new limit, requests will be blocked immediately. It’s better to set the limit first, then let usage naturally decrease.
What happens if I exceed my limit?
What happens if I exceed my limit?
Requests will be blocked with an error indicating you’ve exceeded your spending limit. You’ll need to either wait for the next billing period or increase your limit to continue making requests.
Next Steps
Billing & Invoices
Manage your subscription and view invoices
Usage Tracking
Monitor your API usage and consumption
Dashboard
Explore the full monitoring dashboard
Account Settings
Manage your account settings