Pricing & Billing

Docs-depth version of the pricing page. Full formula, rate cards, and billing mechanics.

Billing tiers at a glance

Overage rates (Startup + Growth)

What counts as an agent?

Any unique agent_name that has called spineforge.init() and produced at least one action in the billing period. Test agents (e.g. agent_name="test") count if they emit actions. Agents that are registered but produce zero actions in a period are not counted.

What counts as an action?

One LLM call or tool invocation captured by the OTel span pipeline. If your agent makes 3 LLM calls per user query, that's 3 actions. Tool calls decorated with @track_tool or auto-captured by a framework instrumentor each count as one action. Spans silently ignored by the span processor (HTTP, framework internals) do not count.

How cost is computed — the formula

For each LLM call action:

cost_usd = (prompt_tokens    / 1000) × cost_per_1k_prompt_tokens
         + (completion_tokens / 1000) × cost_per_1k_completion_tokens

# Stored as NUMERIC(14,8) — precision to sub-cent

Cost is computed once, at write time, using the rate card in effect at that moment. It is stored on the action row and never recomputed. See Metrics Reference for the full step-by-step pipeline.

Billing period and invoicing

• Billing periods are calendar months (UTC).
• Startup and Growth tiers: monthly flat rate billed at the start of each period, overages billed at end of period.
• Enterprise: invoiced per custom agreement.
• Free tier: no payment method required.

Data retention

Next steps

• Pricing page — interactive estimator and tier comparison
• Metrics Reference — how every cost figure is computed