Skip to main content

​
Token-based pricing

ORCA uses a token-based billing model. Every AI-powered operation consumes tokens from your monthly allowance. Tokens refill at the start of each billing cycle.

​
Plans

FreeProEnterprise
PriceFreeEUR 99/monthEUR 499/month
Monthly tokens505,00025,000
OverageNot availableEUR 0.03/tokenEUR 0.025/token
Overage cap—2x allowance (10,000)2x allowance (50,000)
AI tierBasic onlyBasic or AdvancedBasic or Advanced
Report scheduling—Weekly, monthly, quarterlyWeekly, monthly, quarterly
Team members1UnlimitedUnlimited

​
Token costs per operation

Each operation has a different token cost depending on the selected AI tier:
OperationBasic (Gemini)Advanced (Sonnet)
Classification (per column)13
Chat — simple query13
Chat — complex query25
Chat — action query38
Report generation510
AI Readiness scoringFreeFree
AI Readiness scoring is always free — it is a core feature of the platform.

​
AI tiers

ORCA offers two AI tiers that determine which model processes your data:
BasicAdvanced
ModelGemini 2.5 FlashClaude Sonnet 4
Best forHigh-volume classification, standard analysisComplex queries, nuanced classification
Token costLower2-3x higher
SpeedFasterSlightly slower
AvailabilityAll plansPro and Enterprise only
Switch tiers from Settings > Billing or via the API: 
curl -X PATCH https://api.orca-klavest.app/api/v1/billing/ai-tier \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ai_tier": "advanced"}'
Switching tiers requires the admin role. The change takes effect immediately for all subsequent operations.

​
Checking your balance

​
From the UI

Navigate to Billing in the sidebar to see your current token balance, monthly allowance, usage breakdown, and billing cycle dates.

​
From the API

curl https://api.orca-klavest.app/api/v1/billing/token-status \
  -H "Authorization: Bearer $TOKEN"
Response: 
{
  "data": {
    "balance": 4250,
    "allowance": 5000,
    "used": 750,
    "plan": "pro",
    "ai_tier": "basic",
    "cycle_start": "2026-03-01T00:00:00Z",
    "cycle_end": "2026-03-31T23:59:59Z"
  }
}

​
Token ledger

Every token transaction is recorded in an append-only ledger. The ledger provides a complete audit trail of token consumption and refills. 
curl "https://api.orca-klavest.app/api/v1/billing/token-ledger?limit=10" \
  -H "Authorization: Bearer $TOKEN"
Response: 
{
  "data": {
    "total": 142,
    "entries": [
      {
        "id": "e1f2a3b4-...",
        "delta": -2,
        "balance_after": 4248,
        "operation": "chat_complex",
        "ai_tier": "basic",
        "metadata": {"conversation_id": "..."},
        "created_at": "2026-03-31T14:30:00Z"
      }
    ]
  }
}
Filter by operation type using the operation query parameter: 
curl "https://api.orca-klavest.app/api/v1/billing/token-ledger?operation=classify" \
  -H "Authorization: Bearer $TOKEN"

​
How tokens are deducted

Tokens are deducted at the time the operation is initiated:
  1. The system checks your available balance.
  2. If sufficient tokens are available, they are deducted atomically using a database lock.
  3. If the operation fails (e.g. queue unavailable), tokens are refunded automatically.
  4. If your balance is insufficient, the operation returns a 402 Payment Required response.
Overage tokens are charged at the end of the billing cycle for Pro and Enterprise plans. Free plan users cannot exceed their monthly allowance.

​
API reference

MethodEndpointDescription
GET/api/v1/billing/token-statusCurrent token balance, allowance, plan, and cycle
PATCH/api/v1/billing/ai-tierSwitch AI tier (admin only)
GET/api/v1/billing/token-ledgerPaginated token transaction history