Membership · billing
One Clavue account powers every official surface (OpenAI/Grok-style). Plans differ by quota size, not by which models you may call. Free already includes all official product models with smaller daily pools. Live constants: GET /api/membership/plans → billing.
Shared account · shared quota
Auth is one identity; usage.json counters are per userId, never per device or app.
- www.clavue.com — cookie session Domain=.clavue.com
- chat.clavue.com — same cookie + SSO hop to www
- api.clavue.com — Bearer session or cv_live_ API key
- imux IDE / CLI / TUI / Mobile — Bearer to membership /v1
- Chat · image · video billable routes all call consumeQuota
Plans (subscription)
Bands scale from a Paid×1 baseline. Checkout kind=plan stacks remaining paid days (idempotent order keys).
- Free — no card; 20 fast + 5 premium / UTC day shared everywhere
- Paid×1 — first month free once; baseline day/week/month caps
- ×5 / ×20 — multi-agent and heavy automation headroom
- Teacher / Student — education pricing after verify; teacher seats
- Paid plans require future planExpiresAt; expired → free limits
Fast vs premium pools
Unit = one billable request turn (chat completion, image, or video). Fast covers lighter SKUs (e.g. auto / fast). Premium covers flagship, pro, rev, search, image. Hitting one pool does not empty the other.
Consumption order
Pre-charge before upstream; refund the same charged pool on failure (including topup).
- 1) Week hard cap — boost cannot bypass week limits
- 2) Prefer included plan day quota (also counts to month)
- 3) If day exhausted → auto-spend 1 boost request credit (max 200/UTC day from packs)
- 4) If month exhausted but day open → spend top-up when available
- 5) Else 402 with actions: upgrade · topup · retry_later
Recharge paths
Three ways balance increases — all land on the same user row.
- Subscription plan — Alipay / WeChat checkout · setUserPlan
- Paid 加油包 — pack SKUs 100 / 500 / 2000 conversations; never expire
- Free earn — daily check-in, invite both sides, timed rush packs
- 1 加油包 = 20 request turns; paid top-up credits share the same pool
Where to manage
www.clavue.com — Account, Pricing, Usage, API keys, Education. imux only holds a session token; purchases stay on the membership host. Machine-readable rules: /api/membership/plans.