Subscription plans & what they include#

This page explains how Rayu bills you, what each plan unlocks, and where to see your live numbers. Plans, prices, and rates can change over time, so treat the tables here as a guide and check your account (see Checking your plan & balance) for what applies to you today.

Two ways to use Rayu#

You can run Rayu in two modes, in either the CLI or the VS Code extension:

You can switch between the two at any time with /model — nothing about your account prevents you from using your own keys.

Plan comparison#

How to read the pacing columns:

• Your monthly allowance is not usable all at once. Rayu also applies a rolling weekly budget and a per-5-hour-session cap (5% of the weekly budget — e.g. Pro releases at most ~625 credits per 5-hour window from a 12,500 weekly budget). When a window is exhausted, requests wait until it frees; your credits are not lost.
• Free's limit is different in kind: a 50-turn-per-day cap that applies to hosted turns (your BYOK requests never count toward it), and no hosted models at all.
• Concurrency (how many requests stream at once) and the session-window length (default 300 minutes) are service-wide settings, not per-plan numbers.

Feature access by plan#

Rayu unlocks a number of features with your plan. Current defaults:

Notes:

• * Image and video can also be paid for from a funded pay-as-you-go balance even when your plan does not grant them — so you can pay per use without subscribing, where top-ups are available. Every other gated feature needs the plan.
• Basic deliberately keeps API access off (every other feature is on with Basic).
• Enterprise (coming soon) turns all features on with negotiated limits.
• Gating is soft in the UI (a locked feature shows you an "upgrade required" note instead of disappearing) but enforced for anything that runs on Rayu's hosted models.

Hosted models and example credit rates#

With a Rayu account on Basic, Pro, Plus, or Max, you get the hosted model catalog — the models Rayu hosts for you, billed in credits. The Free plan has no hosted models (BYOK only).

Credit cost is computed per token bucket: credits = (input·rIn + output·rOut + cacheRead·rRead + cacheWrite·rWrite) / 1,000,000 where each r is that model's credits-per-1M rate. See How token credits are charged for the full mechanics.

Every model below is available on Basic and above. Rates are in credits per 1M tokens:

A worked example: one Pro-plan turn on deepseek-v4-pro using 8,000 input + 2,000 output tokens with no caching costs (8,000·1,000 + 2,000·1,000) / 1M = 10 credits. Cache hits are the big saver in long sessions — on DeepSeek V4 Pro a cached input token costs a tenth of an uncached one, and agentic loops hit cache for most of the prompt.

Note: these are current default rates. Plans, prices, model availability, and every rate can change. For live values check /billing or /usage in the CLI/extension, or rayucode.com/plans.

Which providers exist per path#

A single session can mix them: main agent on a hosted model, a subagent on your own provider key (paid plans include per-subagent model routing).

Top-ups and pay-as-you-go#

Beyond your plan allowance, you can buy pay-as-you-go (PAYG) credits:

• In the terminal or the extension: /topup [credits] (alias /buy-credits) — shows the live price quote and a payment flow (card or QR).
• In the dashboard: rayucode.com → billing.
• Top-up availability and the credit-per-dollar rate can change; if purchasing is unavailable, /topup tells you. The minimum top-up is $1. Paid plans (Basic and up) include top-up spending.

How money is spent, per request:

1. Plan credits first. The current period's subscription allowance is drawn down to zero.
2. Then your PAYG wallet. Whatever the plan could not cover comes from your permanent top-up balance. (This split happens within a single request, so the last few credits of a period are never wasted.)
3. Then refusal. If neither balance covers the cost, the request is denied rather than silently over-billed — top up, wait for the window to free, or switch to BYOK.

Two important properties:

• The two balances never merge. Plan credits reset with your billing period; PAYG credits are permanent. They are tracked separately and drawn in the order above.
• Pacing still applies. The weekly and 5-hour windows gate the rate of hosted spending even when your balances are healthy; that is a pace, not a budget. See Credits & limits.

Checking your plan & balance#

Billing commands require a Rayu account sign-in. Upgrades and downgrades (prorated) are handled on the dashboard; the plan change takes effect for the CLI and extension automatically — no reinstall.

See also#

• Credits & limits — pacing windows, concurrency, shortfall handling in detail
• How token credits are charged — the exact billing formula and precision
• VS Code Extension — the same account on the editor side
• API Keys & Credentials — programmatic access for hosted models