compliance_mandate
ai-spend
token-pricing
llm-cost
budgeting
price-table
dated-snapshot
integer-minor-units
mcp:estimate_ai_token_spend

AI Token Spend

Monthly AI token spend estimator and cross-model comparator: per-model monthly cost, cost per request, the component breakdown, and a cheapest-first ranking, priced from a dated price table by an as_of date. Integer USD micros per million tokens with an overflow-safe floor-split cost formula. Refuses ambiguous price entries, missing component prices and cap overruns with named reasons. Prices are an input, never kernel constants: the default is the dated 2026-10-04 provider-page snapshot.

Tool URL: https://ainumbers.co/chaingraph/art-704-ai-token-spend.html AP2/Policy Mandate export: yes

post/v1/tools/estimate_ai_token_spend

Request

  • Base URL: https://ainumbers.co
  • URL: https://ainumbers.co/v1/tools/estimate_ai_token_spend
  • Auth: none declared

Request body

as_ofstring required

Pricing date, a real calendar date as YYYY-MM-DD. The node reads no clock; an entry applies when effective_from <= as_of <= effective_through.

price_tableobject required

Dated snapshot: snapshot_verified_on, currency USD, unit usd_micros_per_million_tokens, and models[] with tier, effective dates and micros prices.

Response

Successful tool execution result

object required

output_payload: as_of, snapshot_verified_on, snapshot_age_days, results[]{provider, model, tier, monthly_micros, per_request_micros, components{input, cached_input, cache_write, output}, price_entry_source_sha256}, ranking[model...], cheapest, refusals[]{provider, model, code, text}, refusal_reason, domain_errors[], scope_note.

Changes

No recorded changes to this operation across all 1 revision of this API.