Package org.mockserver.llm.cost

Class LlmPricing

java.lang.Object

org.mockserver.llm.cost.LlmPricing

public final class LlmPricing
extends Object

Estimated cost calculation for LLM API usage.

A pure lookup over a pricing table keyed on (provider, model) with input/output rates in USD per million tokens. Returns null for an unknown model so callers can distinguish "free/known-zero" from "unpriceable".

Companion dashboard pricing table mockserver-ui/src/lib/llmPricing.ts maintains a parallel table with the same prefix-walk semantics, and is kept in sync with this table. A UI-side drift guard (mockserver-ui/src/__tests__/llmPricing.test.ts) snapshots the expected prefixes and rates and fails if the dashboard table drifts from them, so when refreshing rates update both tables together and update that test's canonical snapshot to match.

Pricing source / freshness: rates are public provider list prices captured 2026-06 (newer families) / 2025-Q4 (original entries). They WILL drift — treat any total as an estimate, not an invoice. Sources: Anthropic (anthropic.com/pricing), OpenAI (openai.com/api/pricing), Gemini (ai.google.dev/pricing).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	LlmPricing.ModelOption	The cheapest model in a provider's pricing table — its prefix label and blended (input+output per-million) rate.
static final class	LlmPricing.PricingEntry	Input/output list price in USD per million tokens.

Method Summary

Modifier and Type	Method	Description
static Double	blendedPerMillion(Provider provider, String model)	The blended (input+output per-million) rate for a provider/model, or null when the model is unpriced.
static LlmPricing.ModelOption	cheapestModel(Provider provider)	The cheapest model in the provider's pricing table by blended (input+output per-million) rate, or null for OLLAMA / unknown / tableless providers.
static Double	estimateCostUsd(Provider provider, String model, long inputTokens, long outputTokens)	Estimate the cost in USD for a provider, model, and token counts.
static LlmPricing.PricingEntry	getPricing(Provider provider, String model)	Look up pricing for a provider and model, or null if unrecognised.
static boolean	isApproximateRate(Provider provider, String model)	True when the provider/model resolves to an admitted-placeholder / approximate rate (e.g. gpt-5*), so any cost derived from it must be flagged as an estimate rather than fact.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

getPricing

public static LlmPricing.PricingEntry getPricing(Provider provider,
 String model)

Look up pricing for a provider and model, or null if unrecognised.

estimateCostUsd

public static Double estimateCostUsd(Provider provider,
 String model,
 long inputTokens,
 long outputTokens)

Estimate the cost in USD for a provider, model, and token counts.

Returns:

the estimated cost in USD, or null if the model is unknown. Returns 0.0 for zero tokens on a known (priced) model.

isApproximateRate

public static boolean isApproximateRate(Provider provider,
 String model)

True when the provider/model resolves to an admitted-placeholder / approximate rate (e.g. gpt-5*), so any cost derived from it must be flagged as an estimate rather than fact. False for an unpriced model (no entry) or a verified list price.

cheapestModel

public static LlmPricing.ModelOption cheapestModel(Provider provider)

The cheapest model in the provider's pricing table by blended (input+output per-million) rate, or null for OLLAMA / unknown / tableless providers. Deterministic: ties resolve to the first table entry.

blendedPerMillion

public static Double blendedPerMillion(Provider provider,
 String model)

The blended (input+output per-million) rate for a provider/model, or null when the model is unpriced.