Token Plans

A Token Plan is a monthly subscription that gives you three times its price in model usage: pay $20, get $60 of credit to spend at list price. It suits steady, heavy use — coding agents above all — where usage adds up every day.

See the Token Plans page for the current tiers and prices.

How the credit works

• Credit is spent at list price. Each request draws its cost from the plan's credit at the model's published price. The multiplier is the saving; there's no second discount on top.
• Every month starts fresh. On renewal the credit resets to the plan's full amount. Unused credit does not carry over.
• No hourly, daily or weekly limits. Spend the month's credit as fast or as slowly as you like.
• One shared allowance. All of the plan's keys draw from it.

What a plan covers

Plans cover text models and image generation. A few models stay pay-as-you-go only; the Token Plans page lists them. Other capabilities — embeddings, audio, video, search and the rest — need a pay-as-you-go key.

A plan key that calls something outside its plan gets a 403, and nothing is charged. GET /v1/models with a plan key lists only what the plan covers, so model pickers don't offer anything that would be refused.

Your plan workspace

A plan has its own workspace, separate from any pay-as-you-go organization, so the two never draw on each other. In it you get:

• Dashboard — credit remaining, credit used this period, and the renewal date.
• API keys — as many named keys as you want.
• Logs and analytics — every request, with the credit it consumed.

Switch to it from the workspace selector. Set up your agents from the coding agents guides; a plan key works exactly like any other key.

Change or cancel

Manage the plan under Plan & billing in the plan workspace.

• Upgrade — takes effect immediately. You pay the new plan's full price that day, your month restarts, and the credit you haven't spent is added on top of the new plan's amount.
• Downgrade — takes effect at your next renewal. Nothing is charged today.
• Cancel — the plan runs to the end of the period you paid for, then stops renewing. Keys and history stay available.

If a renewal payment fails, the credit is paused until the payment goes through; update the card or pay the outstanding invoice from the same page.

Plan payments are not refunded. The Token Plan terms have the details.

Checking credit from code

GET /v1/key with a plan key returns the plan tier and its credit used, total and remaining — see authentication.