Token Plan

Token Plan helps you lock in a predictable monthly AI budget with a 30-day prepaid subscription that has a fixed token/request allowance per model — instead of paying per token actually consumed like PAYG.

Architecture

Token Plan is a subscription entirely separate from your existing PAYG API Key, accessed through a subscription-key and a dedicated endpoint.

Portal (Packages / My Token Plans)
   → Billing API (purchase, renewal)
   → Subscription Service (create/manage subscription-key, plan limits)
   → MaaS Gateway (enforce rate limit + model access per plan)
   → Model Providers

Portal: Token Plan sits under the API Key group, next to API Keys, on AI Platform.
Subscription Endpoint: one shared host, tokenplan.api.greennode.ai, separate from the GreenNode MaaS Endpoint used by PAYG API Keys. Whether you append /v1 depends on your tool's standard:
- OpenAI-standard tools (Cursor, OpenCode, Codex…): https://tokenplan.api.greennode.ai/v1
- Anthropic-standard tools (Claude Code, Claude Desktop): https://tokenplan.api.greennode.ai — no /v1

Key Components

Packages

A catalog of plans configured by Admin/Pricing — each plan bundles a name, included models, per-model token/request limits, price, and a maximum subscription-key count. You browse, view details, and purchase directly.

My Token Plans

The list of plans you've purchased. Each plan is an independent plan instance — buying multiple plans in parallel never pools quota, even across the same Plan Type or overlapping models. Each plan has its own Plan Detail page with 2 tabs: Models (call reference — endpoint, model code) and Subscription keys (the keys created in this plan).

Subscription Key

A dedicated key for calling models within a plan's allowance, entirely separate from your PAYG API Key — it never appears in the same key-selector dropdown anywhere in AgentBase. When you buy a plan, the system auto-creates 1 default key (default-key); you can create more keys up to the plan's max-key limit — every key in the same plan shares that plan's token/request allowance, no per-key quota. A subscription-key automatically shows up on the Access Control page with Key Type = Plan: {plan name}, and is excluded from the Rate Limit page.