Token costs and AI ROI

Uncached token

Also known as Uncached token metric, Uncached token analysis

By WeavePublished 2 min read

Definition

Uncached token is an input token processed without a reusable cache hit. It gives teams a way to name, measure, or reason about an economic property of an AI workload without treating raw usage as proof of value.

+## Why Uncached token matters

Uncached token gives an AI program a more precise vocabulary than a single monthly invoice. Teams should define the measured unit, time window, owner, and decision the number is meant to inform. This entry focuses on an input token processed without a reusable cache hit. Two workloads can have similar token counts while serving different users, routes, quality thresholds, or business purposes.

A concrete example

Consider this example: a changing customer message remains uncached while a policy header is reused. An analyst would record the relevant requests, separate direct model charges from adjacent operating costs, and state whether the figure is an average, total, or rate. The report should preserve dimensions needed to reproduce the calculation, including model, provider, environment, workflow, and outcome status where available. A useful review asks what changed, who owns the change, and whether the result remained acceptable for users.

How to use the measure

Start with a baseline, then compare periods with the same scope. Segment unusual results before changing a prompt, budget, or route. Pair the economic measure with quality, latency, reliability, and adoption signals so an apparent saving does not hide lower completion or more manual work. Keep pricing assumptions dated, document exclusions, and distinguish observed facts from forecasts.

Limitations

uncached volume cannot be inferred from prompt length alone. Uncached token should therefore be used as evidence in a decision rather than as a universal score. Recheck the definition when the workflow, model mix, billing rules, or success criteria change.

How this relates to Weave

For teams using Weave, Uncached token is most useful when connected to request-level token usage, model and route context, latency, quality signals, and workflow outcomes. That context helps teams investigate Uncached token by product or team and compare economic movement with engineering results. Weave data should support the measurement conversation, while the team remains responsible for defining the unit, validating assumptions, and deciding what action is appropriate.

Explore Token intelligence

Sources and further reading

  1. NIST AI Risk Management Framework