Usage

Usage shows what your organization's workflows consumed and what they produced. It is how you answer "where is the spend going?" and "how much did the newsroom turn out?". The page is read-only; the caps that limit spending are changed under Settings.

It has two tabs, and each needs its own permission:

• Spend needs usage-spend:read.
• Editorial needs usage-editorial:read.

Owners and admins hold both. Members and Viewers hold neither, so for them Usage is missing from the sidebar and the address sends them back to the Dashboard. Someone holding only one permission sees only that tab. The page sits under Organization in the sidebar. See Roles and permissions.

Read the Spend tabCopy Anchor Link

The tab opens on Last 30 days, by day. It has three parts:

• Against your caps shows your daily, weekly and monthly caps against what has been spent, with when each Resets (in UTC), and says whether spending is running normally, stopped because a cap was reached, or awaiting a resume. Adjust caps leads to Settings. It covers only work Nuvelics pays for. If no cap is set it says No spending caps configured.
• Nuvelics Spend charts the Estimated cost of the work Nuvelics paid for on your behalf.
• 3rd Parties Usage charts what ran on your own credentials, as a Quantity of one unit at a time, X posts or xAI Searches, because different units cannot be added together. It is never capped. If nothing ran on your own credentials the chart says No consumption was recorded on your own credentials.

To change a chart:

1. Choose Day or Month for the period.
2. On Nuvelics Spend, group by No grouping, Provider, Model or Task. It starts grouped by provider.
3. On Nuvelics Spend, filter by Task, such as enrichment or output writing, using the Task picker.
4. Choose a date range: Last 7 days, Last 30 days, All time or a Custom range with From and To.

Beside any chart, Show values reveals the numbers behind it, Copy table copies them and Export CSV downloads them. A chart shows its largest groups and merges the rest into Other. Choose the info button beside a task name, labelled About and the task, for what it measures: enrichment synthesis, for example, is "model tokens spent writing a story's enrichment from the retrieved sources". Costs are estimates unless a provider reported an exact one, and none is a bill. See Spend caps and usage.

Read the Editorial tabCopy Anchor Link

The Editorial tab counts what the pipeline produced, never cost:

• Pitches charts the pitches generated per period. Group them by Topic, Location or Newsdesk. A pitch with several topics or locations is counted under each, so grouped bars add up to more than the number of pitches; the ungrouped chart counts each pitch once.
• Enrichments charts the enrichment runs started per period, and can be limited to one newsdesk or All newsdesks, and grouped by Topic, Location or Newsdesk. These are runs, not stories: a story enriched again counts once per attempt, and a failed run still counts in the period it started.

Both charts take the same period and date range controls, and the same Show values, Copy table and Export CSV.

Other ways to read usageCopy Anchor Link

• CLI: nuvelics usage-events lists and summarizes usage, and nuvelics spend-caps reads and sets the caps.
• API: Audit and usage and Spend caps.