Documentation
Learn how to use ae.app, from API calls to CLI integration.
Billing & Plans
ae.app gives you a single API key and a fixed monthly plan. Each plan includes a set number of API calls per month and a per-minute rate limit. No per-request billing — just predictable, flat-rate pricing.
Plans Overview
Free
$0/mo
For experimenting and side projects.
- 10 API calls / month
- 10 requests / minute
- Community support
Pro
$29/mo
For builders shipping production agents.
- 1,500 API calls / month
- 100 requests / minute
- Email support
Max
$99/mo
For power users deploying at scale.
- 10,000 API calls / month
- 500 requests / minute
- Priority support
- Workspace management
Enterprise
Custom
For organizations with custom needs.
- Custom API call volume
- Custom rate limits
- Dedicated support
- SLA guarantees
How Quotas Work
Every API call routed through ae.app counts against your plan's monthly call limit. Each request uses one call, regardless of the upstream provider.
- Monthly Reset: Call counts automatically reset at the start of each billing cycle.
- Per-User Limits: Each account has a monthly call limit determined by your plan (e.g., 10 for Free, 1,500 for Pro, 10,000 for Max). Enterprise plans have custom limits.
- Overage Protection: Once you hit your call limit, requests return
402 Payment Requireduntil the next billing cycle. Upgrade your plan to increase your limit immediately.
Tracking Quota Usage
Every proxy response includes quota headers so you can programmatically track your remaining calls:
const response = await fetch(
"https://api.ae.app/v1/call/open-meteo/forecast/v1/forecast?latitude=40.71&longitude=-74.00",
{ headers: { "Authorization": "Bearer YOUR_AE_API_KEY" } }
);
const remaining = response.headers.get("X-AE-Calls-Remaining");
const limit = response.headers.get("X-AE-Calls-Limit");
const plan = response.headers.get("X-AE-Plan");
console.log(`Plan: ${plan}`);
console.log(`Calls remaining: ${remaining} / ${limit}`);
if (parseInt(remaining ?? "0", 10) < 100) {
console.warn("Low quota — consider upgrading your plan");
}Upgrading and Downgrading
You can change your plan at any time from the Settings > Billing section of the dashboard.
- Upgrades: Take effect immediately. Your new limits apply right away.
- Downgrades: Take effect at the start of the next billing cycle.
- Mid-cycle usage: Any usage accrued before changing plans is preserved.
See Also
- Pricing — Compare plan tiers and monthly call limits
- API Reference — See quota and rate-limit headers in responses