Plans and Credits

Every agent run needs a way to pay for the underlying model calls: either your own API key (BYOK) or the platform's key, metered against your organization's credit balance.

How metering decides which key is used

When a run starts, the platform checks your organization in this order:

1. You have a BYOK key saved. The run uses your key. It is not metered — see Bring your own keys for details.
2. No BYOK key, but you're on a paid plan with a positive credit balance. The run uses the platform's key. Your credit balance decrements per run.
3. No BYOK key and no credits (including the FREE plan). The run cannot start. You'll need to either add a key or upgrade to a paid plan.

This check happens before the agent does any work, so you'll never be charged for a run that couldn't start.

The FREE plan

The FREE plan has no credit allocation for platform-key runs. To run an agent on the FREE plan, you must add a BYOK key. Without one, every run attempt returns an upgrade-required error until you either add a key or move to a paid plan.

Included limits and overage

Paid plans include a set amount of usage and published overage rates beyond that. For current plan tiers, included limits, and overage pricing, see the pricing page — this doc intentionally doesn't restate numbers that change independently of the product.

Billing

Billing is handled through Stripe. Your plan, invoices, and payment method all live under your organization's billing settings. Upgrading, downgrading, or changing payment details is a self-serve Stripe-backed flow — you don't need to contact support for routine plan changes.

Checking your balance

Your organization's current credit balance is visible in billing settings alongside your plan. If a run fails because credits ran out, the fix is either:

• Wait for your plan's next credit refresh (per your plan's billing cycle), or
• Upgrade to a plan with a higher allocation, or
• Add a BYOK key so runs stop drawing from the platform balance entirely.

Mixing BYOK and platform credits

You don't have to choose one path for your whole organization. If a BYOK key is saved, it's used first and nothing is metered. Remove the key and the organization falls back to platform credits automatically, as long as the plan is paid and the balance is positive. This makes it easy to test with your own key during development and switch to platform billing later, or vice versa.

Troubleshooting

If a run won't start, check whether the organization is on FREE with no key, or on a paid plan with an exhausted balance — both produce the same "can't run" behavior with different fixes. See Troubleshooting for the full breakdown.