The Subscription page shows your plan, balance, and usage. What you can do here depends on the billing mode the platform runs: self-use, subscription billing, or usage billing.
Where to find it#
- Open the user menu at the bottom of the sidebar.
- Choose Settings.
- Select Subscription.
You can also open the same page from the user menu item Upgrade plan.
Understand the billing modes#
| Mode | What the page shows | What you can do |
|---|---|---|
| Self-use | Billing mode set to Self-use mode. | Review activity, usage trends, and usage logs. No plan purchase or top-up. |
| Subscription billing | Current subscription, Subscription entitlements, Plan usage, Overage billing. | Subscribe, renew, upgrade, switch plans, redeem codes, and top up for overage. |
| Usage billing | Usage billing, Account balance, Total spent. | Top up and redeem codes. |
An administrator selects the mode in the admin console. Buttons that do not appear are not enabled for the platform.
Self-use mode#
If the page shows Billing mode: Self-use mode, the platform does not charge users through plans or balance.
- No Subscribe, Top up, or plan cards are shown.
- The activity overview, usage trends, and usage logs are still available. Use them to watch usage and performance, not to settle a bill.
- Cost columns and cost metrics may still appear, but no money is deducted from your account.
Subscribe, renew, or switch a plan#
In subscription billing mode:
- In Current subscription, click Subscribe to open Subscription plans.
- Compare the plan cards. Each card shows the plan name, the price per interval, and its features, including the period credit and the note that free models do not count toward the credit.
- Click the action button on a plan.
The button label depends on your current plan.
| Action | Meaning |
|---|---|
| Current plan | This is your active plan. Free plans cannot be subscribed to again. |
| Subscribe | You have no paid plan yet. The paid plan starts immediately. |
| Renew | The same plan or a lower plan is added after your current entitlement. |
| Upgrade | A higher plan starts immediately and your unused entitlement is preserved after it. |
| Switch | A plan with no price (for example a free plan) replaces the current one. |
| Unavailable | The plan has no usable price. Ask an administrator to check the billing configuration. |
| Base plan | You cannot move down to the free plan while a paid entitlement is active. Renew or choose another paid plan. |
- If the plan is paid, the payment dialog opens. Its title is Payment method, Renew subscription, or Upgrade subscription, depending on the action. Confirm the method and click Continue to finish payment in the provider's checkout page.
- A renewal adds time after your current entitlement. If a higher-tier entitlement is still active, the dialog explains that the new plan starts after the higher entitlement ends.
- An upgrade starts immediately and preserves the unused entitlement after it.
- If the plan is free, it is applied directly and the page reloads with the new plan.
After payment, the page shows Subscription plan updated once the provider confirms the order.
Read the current subscription and entitlements#
In subscription billing mode, Current subscription shows the plan name, the price per interval, and the period credit.
Subscription entitlements lists the current and upcoming entitlement segments in time order. Each segment shows the plan and its date range. Renewals, upgrades, and purchases with different periods are queued here. If a higher-tier plan is still active, a lower-tier renewal starts after the higher entitlement ends.
Plan usage shows the current billing period, the used credit, the total credit, and the used percentage. When usage approaches the limit, use cheaper models, wait for the next period, or move to a plan with more credit.
Overage billing shows Available balance. If the platform has a payment channel, a Top up button appears here.
Top up your balance#
In usage billing mode, the page shows Usage billing, Account balance, and Total spent.
- Click Top up.
- Enter a Top-up amount. The value must be greater than 0. The input currency follows the platform display currency.
- Choose a Payment method.
- Click Top up and finish payment in the provider's checkout page.
If the amount is invalid, the toast reads Invalid top-up amount and Enter a USD amount greater than 0. If no payment channel is configured, the button is hidden or disabled. Ask an administrator to configure a provider.
Redeem a code#
In subscription billing and usage billing modes, click Redeem.
- Enter the Redemption code provided by an administrator.
- Click Redeem.
A successful redemption updates your entitlements, period credit, or balance, depending on the code type. If redemption fails, the code may be invalid, already used, expired, exhausted, or meant for a different billing mode.
Review your activity#
Activity over the past year is a heatmap of your usage.
- Switch between Tokens and Requests.
- Hover a cell to see the exact requests and tokens for that day.
Above the heatmap, four tiles summarize Highest daily tokens, Current streak, Longest streak, and Active days. The footer shows the total requests in the past year.
Review usage trends#
Daily usage trend and Monthly usage trend chart your usage over time.
- Switch between Daily and Monthly.
- Read the summary tiles: Period cost (daily view) or 12-month cost (monthly view), Total tokens, Total calls, and Average latency.
- Hover a bar to see the exact tokens, cost, calls, and average latency for that day or month.
The daily chart stacks tokens by model and groups smaller models under Other. Click a legend item to hide or show that model.
Review usage logs#
Usage logs lists individual model calls.
- Use the search box to filter by model.
- Use Type to filter All, Free models, or Billable models.
- Use the sort menu to order by Newest calls, Oldest calls, Most tokens, Highest cost, or Longest latency.
- Hover a value in Base billing or Service billing to see the billing breakdown, including input, output, cache read, cache write, multipliers, and the final total.
| Column | Meaning |
|---|---|
| Time | When the call happened. |
| Model | The platform model used. |
| Base billing | Charges for the model call itself. |
| Service billing | Charges for attached services such as MCP tool calls. |
| Balance after settlement | Account balance after the call. |
| Latency | Call duration. |
Common problems#
| Problem | What to check |
|---|---|
| Subscribe is missing. | The platform is in self-use mode, or no plans are available. |
| Top up is missing. | No payment provider is configured, or the platform is in self-use mode. |
| Payment provider is disabled appears. | An administrator must configure a payment provider in the admin console. |
| Plan unavailable appears. | The plan has no usable price. Ask an administrator to check the billing configuration. |
| A paid plan cannot switch to the free plan. | Active subscription entitlement: renew or choose another paid plan instead. |
| Balance does not refresh after payment. | Reopen the Subscription page after the provider confirms the order. |