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
Popular

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 Required until 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