Documentation

Quick start

Sign up with your email — magic-link, no password.
Add subscriptions from our catalog of 42 plans.
Upload usage as CSV or JSON from your provider dashboards.
See your dashboard — monthly cost, trends, recommendations.

CSV format

Each provider exports slightly differently. Here are the formats we accept.

OpenRouter

created_at,model,prompt_tokens,completion_tokens,cost
2026-06-15T10:23:00Z,anthropic/claude-sonnet-4,1234,567,0.0135

OpenAI

timestamp,model,input_tokens,output_tokens,cost_usd
2026-06-15 10:23:00,gpt-4o,1234,567,0.0124

Anthropic

date,model,input_tokens,output_tokens,cost
2026-06-15,claude-sonnet-4-5,1234,567,0.0141

z.ai (GLM)

time,model,prompt_tokens,completion_tokens,total_cost
2026-06-15T10:23:00,glm-4.5,1234,567,0.0021

JSON API

curl -X POST https://aispend-api.jonlab.sh/api/v1/usage/upload \
  -H "Authorization: Bearer <your_api_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {"provider": "openrouter", "model": "anthropic/claude-sonnet-4",
       "input_tokens": 1234, "output_tokens": 567, "cost_usd": 0.0135,
       "occurred_at": "2026-06-15T10:23:00Z"}
    ]
  }'

Recommendations engine

AISpend ships with rule-based recommendations. Examples:

“You have Claude Code Pro ($20/mo) and use less than 30% of Opus — switch to Pro ($20/mo) and save $X.”
“You’re spending $80/mo on OpenRouter pay-as-you-go. Kilo Pass ($19/mo) would cover your usage and save $60/mo.”
“Your z.ai GLM Pro quota is at 12% — downgrade to Lite ($3/mo) and save $12/mo.”

Self-host

AISpend is a Hugo static site + FastAPI backend + SQLite database. Self-hostable via Docker:

git clone https://git.catalystgroup.tech/herman/aispend.git
cd aispend
docker compose up

Full self-host guide ships with v1.1.

Need help?

Open an issue at git.catalystgroup.tech/herman/aispend or email hello@aispend.io (forwarded to Herman).