# Token Plan

> An optional monthly plan with a fixed quota, on the separate endpoint api-plan.vikey.ai with the model vikey/plan.

Token Plan is an optional monthly plan, from Rp100.000 per month. You pay once up front with QRIS and get a usage quota, without thinking about per-token prices. Token Plan fits steady usage when you want a fixed monthly cost. The current plan prices are always shown in the **Token Plan** menu of the dashboard.

## How it differs from pay as you go

| | Pay as you go | Token Plan |
| --- | --- | --- |
| Payment | Top up a balance, charged per token | Pay for the plan monthly with QRIS |
| Base URL | `https://api.vikey.ai/v1` | `https://api-plan.vikey.ai/v1` |
| Models | Every model in the catalog | One model id: `vikey/plan` |
| Model choice | You choose, or use Vikey Auto | Vikey picks the capability level that fits each message |
| Renewal | No subscription | Not renewed automatically |

## Quota

Token Plan uses a fair-use quota, not per-token billing like pay as you go. There are two windows:

| Window | How it works |
| --- | --- |
| Per 5 hours | Counted back from your latest usage, not reset at a fixed hour |
| Per week | The same, counted back from your latest usage |

Usage in each window and when it is fully available again are shown under **Token Plan**, then **Usage Limit**. Large requests use more quota than small ones.

When either window is full, requests are rejected until the quota recovers. If you would rather not wait, turn on **Lanjut pakai saldo kalau limit tercapai** on the same page: extra requests keep running and are billed from your normal balance, at the pay-as-you-go price of the model that served them plus the model selection fee. If the balance is empty too, requests are rejected. This option is off by default.

## Using Token Plan

Every coding agent guide in these docs applies, with two differences:

1. The base URL becomes `https://api-plan.vikey.ai/v1` (OpenAI format) or `https://api-plan.vikey.ai` (Anthropic format).
2. The model is always `vikey/plan`, including for background tasks such as session titles.

Claude Code example:

```json title="~/.claude/settings.json"
{
  "model": "vikey/plan",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api-plan.vikey.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "vikey/plan"
  }
}
```

Codex example:

```toml title="~/.codex/config.toml"
model = "vikey/plan"
model_provider = "vikey-plan"

[model_providers.vikey-plan]
name = "Vikey Token Plan"
base_url = "https://api-plan.vikey.ai/v1"
env_key = "VIKEY_API_KEY"
wire_api = "responses"
```

Ready-to-copy snippets for other tools are in the **Token Plan** menu of the dashboard.

The Token Plan endpoint only serves `vikey/plan`. Other model ids such as `openai/gpt-6-luna` are not available there, so do not use other models for background tasks with Token Plan.

## Terms

- Payments are final and cannot be refunded once successful.
- For organizations, only the owner can buy a plan.
- A plan can be given to another account as a gift. If the recipient already has the same plan, its active period is extended.

Source: https://docs.vikey.ai/en/models/token-plan/