Skip to main content
Qualia displays a banner when your plan usage or overage spend reaches an important threshold. The banner links to the relevant billing action, such as upgrading your plan, enabling overage, or adjusting your overage ceiling.

​
How tokens are counted

The Tokens total on Settings > My usage in Qualia Cloud counts every token you were charged for. That includes cached tokens, which are billed at a reduced rate rather than free, so they count toward the total alongside the input and output tokens you send and receive. Because cached tokens are included, this total is comparable to the figure your model provider reports. Reasoning tokens are already part of your output tokens and are not added again.

​
Label usage by workstream

To identify a workstream in billing exports, set a label before launching Qualia or the Qualia CLI from your terminal:
Fully quit an existing desktop instance first, then launch it from that terminal and start a new chat. New agents created within a labeled chat inherit its label. Changing the variable does not relabel earlier usage. Labels are lowercased, spaces and punctuation become dashes, and slashes separate groups. For example, Team/Weekly Analysis becomes team/weekly-analysis. Use consistent names across your team. Use the attribution column in Settings > My usage > Export CSV to identify labeled usage. Without a custom label, Qualia uses a default identifying desktop, cloud, or CLI usage.

​
Export usage data

Open Settings > My usage in Qualia Cloud, choose a range of 7, 30, or 90 days under Trends, then select Export CSV to download that range. The export includes 15-minute usage intervals, models, token counts, request counts, and cost. Each interval also carries a billable token total, matching the Tokens figure on that page. Organization owners and admins can export usage for current organization members from Settings > Usage & limits in Qualia Cloud. See Your account and organization. Exports are saved as a CSV file. If an export fails (for example, because your session expired), an error message appears.

​
Snooze a notification

Select the alarm clock on the banner, then choose when you want the notification to return:
  • In 1 day
  • In 5 days
  • In 1 week
  • At the end of the current billing period
Your choice persists if you restart Qualia. The banner can appear again after the snooze expires if your usage still meets a notification threshold. Select the close button to dismiss the current threshold without setting a snooze.