CloudRouter 文档

English

简体中文

English

简体中文

Appearance

Billing & Usage Monitoring ​

Applies to: Organization (top-level user), Subuser Updated: 2026-07-02

The new console gives each organization a dedicated Dashboard and Usage Records page, helping you answer in one place: "How much did I spend this month, who is spending it, on which models, and is anything abnormal?" This article explains what the dashboard shows, how to view usage by time and by user, and the caveats around measurement conventions such as "today vs. cumulative".

1. Entry Points ​

EntryPathData scope shown
DashboardLeft nav → Dashboard (/dashboard)Organization-level summary + subuser distribution/ranking
Usage RecordsLeft nav → Usage Records (/usage)Call details by time and by user

Data is strictly isolated by hierarchy: an organization only sees its own data, and a subuser only sees their own usage after logging in. The organization can see the organization-level summary and the usage of each subuser under it; a subuser cannot see other subusers' data.

2. What the Dashboard Shows ​

After the organization logs in, the dashboard provides the following sections:

1. Balance Overview ​

Shows the current balance of the organization balance pool. All subuser spending is deducted from here; the balance is the single source of funds. For low-balance alerts and arrears behavior, see Balance Alerts & Arrears.

2. Spending Trend ​

Shows the organization's spending trend over time, helping you gauge how fast the balance is being consumed and anticipate when you need to top up.

3. Distribution by Model (Top) ​

Shows the spending/usage share of each model in your organization (ranked Top), helping you understand which models your team mainly uses and where costs are concentrated.

4. Recent Usage ​

Shows recent call activity, letting you quickly grasp the current level of activity.

5. Quota Overview Card ​

Shows the organization's quota information on the platform, including the total quota limit, quota used, and so on. The quota limit is the spending cap the platform sets for your organization (i.e. the cumulative-spend counter against the quota limit), and it is a dimension independent of the balance -- the balance determines "how much money is left to use", while the quota limit determines "how much is allowed to be spent at most".

After a subuser logs in, their dashboard shows only their own usage overview, and a read-only "subuser quota card" at the top of the API Keys page shows their quota limit. For the relationship between subuser quota and organization balance, see Three-Tier Account Hierarchy.

3. Viewing Usage Records by Time / User ​

The "Usage Records" page supports viewing call details by time range and by user:

DimensionDescription
Time rangeFilter call records by the selected time window
UserThe organization can filter by subuser to pinpoint "who is spending"

Typical uses:

  • Monthly cost allocation: Select this month's time range, view each subuser's spending by user, and allocate it to departments.
  • Locating high-consumption subusers: Sort by spending, identify the Top-consuming subusers, and verify whether it is reasonable.
  • Investigating abnormal calls: If you find a subuser's usage abnormally high, combine it with the time distribution to judge whether there is a Key leak or an unauthorized script. If you confirm a Key anomaly, you can handle it on the API Keys page.

After a subuser is deleted, their historical usage is rolled up into the owning organization and is no longer retained separately under that subuser dimension. Keep this in mind when reconciling historical data.

4. The "Today" Convention and Time Filtering ​

4.1 Global Time Range Filter ​

The top of the dashboard provides a global time range filter (date-range picker), letting you view spending, model distribution, user rankings, and other statistics for the selected time window. After switching the time range, the dashboard charts refresh to that range's convention.

4.2 "Today" vs. "Cumulative/Range" Conventions ​

Some dashboard statistics carry a "Today" badge, used to distinguish today's data from the selected time range / cumulative data. When reading the numbers, first confirm whether a figure is "today" or "the selected range", to avoid misreading the day's spending as total spending, or vice versa.

Practical tip: For precise reconciliation, prefer the results from the "Usage Records" details filtered by an explicit time range, and use the dashboard cards as a trend and overview reference.

5. Data Notes ​

  • Actual spending: The amount actually deducted from the organization balance; it is the basis for reconciliation.
  • Data freshness: To optimize large-volume queries, some statistics may come from pre-aggregated snapshots and have a minute-level delay; the interface labels the data update time.
  • Details vs. summary: The dashboard shows "trends and distribution", while Usage Records show "line-by-line / item-by-item details"; the two share the same data source but offer different perspectives.

6. FAQ ​

Q: Can the organization see subusers' usage? A: Yes. On the dashboard, the organization can see the distribution and ranking of its subusers, and in "Usage Records" it can filter details by subuser. Subusers cannot see each other, and a subuser can only see their own usage.

Q: Are the numbers on the dashboard "today" or "total"? A: The top of the dashboard has a global time range filter to select a range; numbers with a "Today" badge use the day's convention, and the rest follow the selected range. For precise reconciliation, use the "Usage Records" results filtered by time range.

Q: Why does today's data seem to lag behind what I actually experienced? A: Some statistics use pre-aggregated snapshots to improve query performance and may have a minute-level delay, which is normal.

Q: I deleted a subuser -- where did its previous usage go? A: It is rolled up into the owning organization and is no longer retained separately under that subuser dimension.

Q: Does the dashboard data reconcile with the balance? A: The data source is the same, but the dashboard is an aggregate view (trends/distribution/ranking), while the balance is per-transaction fund movement. For reconciliation, rely on the actual spending details.

Contact Us ​