Overview

Credits are the currency used for AI processing in Contox. They are consumed by the enrichment pipeline when extracting memory items from session data. Every plan includes a base allocation of credits. When that allocation is exhausted, additional credits are deducted from your purchased balance.

Credit packs

Purchase credits in predefined packs:

Larger packs offer better per-token pricing. Credits are added to your balance immediately after purchase.

Credits never expire

Purchased credits remain in your account indefinitely. There is no expiration date. Use them at your own pace.

How credits are consumed

Credits are consumed during the enrichment pipeline:

1. A session's events are processed through the AI model
2. Each AI model call consumes tokens based on input and output size
3. Token consumption is tracked and deducted

The amount consumed per enrichment depends on:

• Number of events -- More events means more AI processing
• Event size -- Larger events (with more diffs and content) consume more tokens
• Model tier -- Medium models consume more tokens than Small models

Consumption priority

1. Plan allocation first -- Your plan's included tokens are used before credits
2. Credits second -- Once the plan allocation is exhausted, purchased credits are deducted
3. No overage -- If both are exhausted and auto-recharge is off, enrichment is paused until credits are purchased

Auto-recharge

Configure automatic credit purchases to ensure uninterrupted service:

Setup

1. Navigate to Billing > Credits in the dashboard
2. Toggle Auto-Recharge on
3. Configure the settings:

How it works

1. After each enrichment, the system checks your credit balance
2. If the balance falls below your threshold, an auto-purchase is triggered
3. The configured pack is purchased and added to your balance
4. The spending limit prevents runaway charges

Spending limit

The spending limit (default: 50.00 EUR per billing period) caps the total amount that can be auto-charged. Once the limit is reached, auto-recharge pauses until the next billing period. You can still purchase credits manually.

Monitoring usage

Dashboard

The billing section shows:

• Current balance -- Available tokens
• Usage this period -- How many tokens have been consumed
• Transaction history -- All purchases and deductions

API

# Get credit balance
curl https://contox.dev/api/billing/credits \
  -H "Authorization: Bearer contox_sk_yourkey"

# Get usage stats
curl https://contox.dev/api/billing/usage \
  -H "Authorization: Bearer contox_sk_yourkey"

Tips for managing credits

• Use the right model -- Free and Personal plans use the Small model, which consumes fewer tokens per enrichment
• Save sessions strategically -- Batch your work into meaningful sessions rather than saving after every small change
• Use context packs -- Context packs are more token-efficient than loading the full brain
• Enable auto-recharge -- Prevents enrichment from stalling when credits run low
• Buy larger packs -- The Enterprise pack offers 50% more tokens per EUR compared to the Starter pack

Next steps

• Billing Dashboard -- Manage credits and billing in the UI
• Billing API -- Purchase credits programmatically
• Enrichment -- Understand what consumes credits