MiniMax Token Plan: Plans, Limits, and Hermes Agent Setup

MiniMax Token Plan is unusually easy to misunderstand. It has a monthly price, an enormous-looking “tokens per month” estimate, and access to language, image, speech, and music models. That can sound like an unlimited API subscription. It is not.

The useful version of the offer is more precise: you pay $20, $50, or $120 per month for a shared multimodal allowance intended mainly for individual, interactive developer work. Usage is governed by rolling five-hour and weekly quota windows, may be throttled during busy periods, and does not carry into the next billing cycle. MiniMax recommends pay-as-you-go rather than Token Plan for production workloads. MiniMax Token Plan FAQ, verified July 31, 2026

That distinction matters before you buy. It also matters when you connect the plan to Hermes Agent, because MiniMax issues a dedicated Subscription Key for Token Plan and Credits. That is not interchangeable with its normal pay-as-you-go API key. MiniMax quickstart, verified July 31, 2026

This guide has two halves. First, it explains exactly what the subscription buys and where its limits sit. Then it walks through creating the account, getting the right key, configuring Hermes Agent, running a smoke test, checking usage, and diagnosing common failures.

The plans at a glance

MiniMax publishes three public tiers. The monthly M3 token figures are estimated equivalents, not a bank of tokens you can draw down without other limits. MiniMax’s live usage bar is the source of truth. MiniMax pricing and FAQ, verified July 31, 2026

Plan	Monthly price	Approx. M3 monthly equivalent	Agent concurrency	Video generation	MiniMax’s fit
Plus	$20	~1.7 billion tokens	~3–4 agents	None	Personal projects, prototypes, daily M3 use
Max	$50	~5.1 billion tokens	~4–5 agents	3 clips/day	Daily professional coding and multimodal work
Ultra	$120	~12.5 billion tokens	~6–7 agents	5 clips/day	Heavy agent workflows, extended sessions, multi-project use

All three include access to the M3 and M2.7 language families plus eligible image, speech, and music resources. They also support image and video understanding as input. Video generation is different: Plus has none, while Max and Ultra get the daily clip limits in the table. All covered text, image, speech, and music activity draws from one shared quota. MiniMax Token Plan pricing, verified July 31, 2026

Annual purchase options were displayed at $200, $500, and $1,200 when checked, described as two months free relative to monthly billing. Treat checkout as authoritative because prices and promotions can change. MiniMax Token Plan pricing, verified July 31, 2026

What the monthly token numbers really mean

The headline equivalents—1.7B, 5.1B, and 12.5B M3 tokens—help compare tiers. They should not be read as a conventional monthly API balance.

MiniMax now deducts usage according to the resource actually consumed. A short text task consumes less than a long-context reasoning task, a multimodal request, or a complex agent run. Different eligible endpoints draw from the same included allowance according to their corresponding pay-as-you-go value. The console translates this into a usage bar rather than asking you to calculate model-specific balances yourself. MiniMax Token Plan FAQ, verified July 31, 2026

Three controls operate at once:

1. A rolling five-hour window. Heavy bursts can exhaust the short window even if the monthly equivalent sounds enormous.
2. A weekly window. Sustained usage can hit the weekly ceiling before the billing cycle ends.
3. Rate limits and dynamic traffic controls. RPM and TPM limits can throttle requests, and MiniMax says limits may tighten during peak traffic. It describes typical peak periods as weekdays around 15:00–17:30, dynamically adjusted with cluster load.

Unused included quota does not roll into the next billing cycle. The subscription therefore buys bounded access over time, not a stockpile you can save for a later month. MiniMax FAQ, “How is usage reset?” and “platform traffic rules,” verified July 31, 2026

Models, modalities, and exclusions

The pricing page says all plans cover the full mainstream MiniMax lineup: M3, M2.7, image, speech, and music. The plan page also advertises a 1-million-token context window for M3 and native image/video input understanding. MiniMax Token Plan pricing, verified July 31, 2026

There are limits to “full access.” MiniMax’s overview names a small set of special resources that are currently outside the included Token Plan coverage, including MiniMax H3, voice design, and rapid voice cloning. The console is the final authority for what your Subscription Key can use at that moment. MiniMax Token Plan overview, verified July 31, 2026

Purchased Credits are a separate supplement. MiniMax sells 5,000 for $5, 25,000 for $25, and 100,000 for $100, valid for 365 days from purchase. Token Plan quota is used first; eligible overflow can then consume Credits automatically. Credits share the plan’s eligible resource coverage and use the same Subscription Key. MiniMax Token Plan pricing docs, verified July 31, 2026

Do not confuse those Credits with the included plan quota, and do not confuse either with the normal MiniMax pay-as-you-go wallet. A standard Open Platform API key bills actual token use against your account balance. MiniMax FAQ, verified July 31, 2026

Which tier should you buy?

Plus: start here for one active operator

Plus is the sensible entry point if you want M3 for Hermes conversations, coding, research, and occasional multimodal tasks. Its ~3–4 agent concurrency should be read as an approximate traffic guideline, not permission to run an unattended batch service. It is also the wrong tier if you specifically need video generation: Plus includes video understanding but no generated clips.

Max: the practical heavy-use tier

Max triples the estimated M3 monthly equivalent over Plus, increases typical concurrency to ~4–5 agents, and adds three video generations per day. It is the strongest fit for someone using Hermes throughout the working day, especially across coding and media tasks. MiniMax itself labels it the daily professional-work tier and “best value.” MiniMax pricing, verified July 31, 2026

Ultra: for sustained parallel work

Ultra is for operators who expect multiple simultaneous agents, long sessions, or several active projects. The jump to ~12.5B estimated M3 tokens and ~6–7 agents is substantial, but it does not remove rolling windows or peak-hour controls. If the real requirement is a customer-facing service with predictable throughput, Ultra is not a substitute for production API capacity.

A safe buying rule is to start one tier lower than your forecast, monitor the usage bar for a week, then upgrade if needed. MiniMax allows an in-cycle upgrade by paying the difference, with the higher tier taking effect immediately. MiniMax FAQ, verified July 31, 2026

Commercial caveats before checkout

Token Plan is designed for individual, interactive developer use. MiniMax explicitly recommends pay-as-you-go for production. Ultra-high-concurrency automation, batch work, and multi-user sharing may trigger traffic controls. MiniMax FAQ, verified July 31, 2026

MiniMax’s referral-program terms describe Token Plan as non-refundable. Its broader paid-service terms say current product pages and service rules govern pricing and restrictions, prices and billing may be adjusted, and ongoing services can continue charging until disabled. Read the checkout and current terms before paying, especially for annual billing. Referral terms, verified July 31, 2026; MiniMax paid-service terms, effective March 30, 2026, verified July 31, 2026

Canceling auto-renewal does not immediately erase already-issued current-period quota, according to the FAQ. Some retired legacy tiers may not be available again after cancellation. MiniMax FAQ, verified July 31, 2026

Before you set up Hermes Agent

You need:

• a macOS or Linux terminal, or Windows using WSL2;
• a MiniMax account;
• an active Plus, Max, or Ultra subscription, assigned team seat, or eligible Credits;
• the Subscription Key from Billing → Token Plan;
• a current Hermes Agent installation.

Direct links:

• Create or sign in to a MiniMax account
• Compare and buy Token Plan
• Open Billing → Token Plan and copy the Subscription Key
• MiniMax’s Hermes Agent integration page
• Hermes Agent documentation

Install Hermes Agent

If Hermes is not installed, use the installer published in the current MiniMax/Hermes integration guide:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Then check the installation:

hermes doctor

Review scripts downloaded with curl | bash before running them if that is your security policy. The authoritative Hermes documentation may change the preferred installation path, so check the current Hermes installation guide when you install. The MiniMax integration page still shows the upstream GitHub copy of the same installer. MiniMax Hermes Agent guide, verified July 31, 2026

Sign up and get the Subscription Key

1. Create or sign in to your MiniMax account.
2. Open the Token Plan page, choose Plus, Max, or Ultra, and complete checkout.
3. Open Billing → Token Plan.
4. Copy the Subscription Key. Keep it private. This is the credential Hermes needs to draw from Token Plan and eligible Credits.

The key can exist before a plan or Credits are attached. If Hermes returns an authorization or no-resources error, confirm that the subscription is active or that a team owner assigned your seat. MiniMax quickstart, verified July 31, 2026

Configure MiniMax in Hermes

The current supported route is the interactive model selector:

hermes model

In the prompts:

1. Choose MiniMax (global endpoint).
2. Paste the MiniMax Subscription Key when asked for the API key.
3. Choose MiniMax-M3.
4. Save the selection and exit the wizard.

Hermes’ native provider ID is minimax, and its credential variable is MINIMAX_API_KEY. The wizard stores provider configuration for you; you do not need to invent a custom endpoint. Hermes’ current provider documentation places persistent API keys in ~/.hermes/.env. Hermes providers, verified July 31, 2026

If you prefer to manage the key yourself, add it to that file without printing it into shell history:

mkdir -p ~/.hermes
chmod 700 ~/.hermes
read -rsp 'MiniMax Subscription Key: ' MINIMAX_KEY; printf '\n'
printf 'MINIMAX_API_KEY=%s\n' "$MINIMAX_KEY" >> ~/.hermes/.env
unset MINIMAX_KEY
chmod 600 ~/.hermes/.env
hermes model

Then select MiniMax and MiniMax-M3. Do not paste the literal placeholder <API Key> or reuse a standard pay-as-you-go key by accident. The Token Plan Subscription Key is the key that draws from the plan.

Command map

Job	Command or action	Observable success state
Check Hermes	hermes doctor	Doctor completes without a blocking install error
Configure provider	hermes model	MiniMax global and MiniMax-M3 are selected and saved
Start interactive use	hermes	A Hermes prompt opens using the configured model
Run one smoke test	hermes chat --provider minimax --model MiniMax-M3 -q "Reply with exactly: MINIMAX_OK"	Output contains MINIMAX_OK
Check Token Plan usage	Open Billing → Token Plan	Usage bar and current plan resources are visible
Query remaining allowance	Run the curl command below	MiniMax returns a JSON response instead of 401/403

The command syntax above was checked against local Hermes Agent v0.19.0 on July 31, 2026. The installation reported an available update, so run hermes update or consult current docs if your picker or help output differs.

Smoke-test the connection

Run a small one-shot request:

hermes chat --provider minimax --model MiniMax-M3 \
  -q "Reply with exactly: MINIMAX_OK"

A response containing MINIMAX_OK proves that Hermes can resolve the provider, read the credential, reach MiniMax, and invoke M3. It does not prove that every media endpoint is enabled or that you have enough allowance for a large agent run.

For normal interactive work, start Hermes with:

hermes

Inside a running Hermes session, /model switches among providers and models you have already configured. To add or authenticate a new provider, exit and use hermes model in the terminal. Hermes providers, verified July 31, 2026

Check usage and remaining quota

The primary method is MiniMax’s Billing → Token Plan usage bar. MiniMax calls it the source of truth.

The FAQ also publishes this endpoint:

curl --location 'https://www.minimax.io/v1/token_plan/remains' \
  --header "Authorization: Bearer $MINIMAX_API_KEY" \
  --header 'Content-Type: application/json'

If your key lives only in ~/.hermes/.env, load it into the current shell without displaying it before running the request. Avoid copying command output into public bug reports if the response contains account identifiers.

Troubleshooting

401 or “invalid API key”

Confirm that you copied the Subscription Key from Billing → Token Plan, not a normal Open Platform API key. Check for trailing spaces and rerun hermes model. Never post the key in a screenshot.

The key exists but has no usable resources

MiniMax can create a Subscription Key before a subscription, Credits balance, or assigned team seat exists. Buy a plan, buy Credits, or ask the team owner to assign a seat. Then retry with the same Subscription Key. MiniMax quickstart, verified July 31, 2026

Requests work, then stop

Check the usage bar. You may have reached the rolling five-hour or weekly window, or a rate limit may have tightened during peak traffic. Options are to wait, upgrade, use purchased Credits, or switch deliberately to a normal pay-as-you-go key. The latter consumes wallet balance and can create variable charges.

The model is missing from the picker

Run:

hermes model --refresh

Then choose MiniMax again. If MiniMax-M3 still does not appear, check MiniMax status, update Hermes, and compare your installed version with current Hermes docs.

Plus cannot generate video

That is a plan limit, not a Hermes defect. Plus supports video input understanding but has no included video generation. Upgrade to Max or Ultra, or use a separately billed video product.

Security and cost controls

Treat the Subscription Key like a paid credential. Keep ~/.hermes/.env owner-readable only, do not commit it, do not paste it into prompts, and rotate or replace it if exposed. MiniMax’s terms make the account holder responsible for activity under the account. MiniMax paid-service terms, verified July 31, 2026

Also keep the billing paths distinct:

• Subscription Key → included Token Plan allowance, then eligible purchased Credits if available.
• Standard Open Platform API key → pay-as-you-go wallet balance.

That separation prevents a quota reset from silently becoming an unexpected metered bill. For a customer-facing application, scheduled batch system, or workload requiring stable throughput, use pay-as-you-go with explicit budgets and monitoring rather than trying to stretch Token Plan beyond its intended use.

Keep this setup current

MiniMax changes model coverage, quota rules, and promotions. Hermes changes model catalogs and setup flows. Before buying or debugging, re-check:

1. the Token Plan pricing page;
2. the Token Plan FAQ;
3. the MiniMax Hermes integration page;
4. the Hermes provider documentation;
5. the live usage bar and checkout shown in your MiniMax account.

Sources

• Prices, annual offers, estimated M3 equivalents, concurrency, media entitlements, context, and video limits: MiniMax Token Plan pricing, verified July 31, 2026.
• Usage-based deductions, rolling windows, non-rollover, upgrades, cancellation, production recommendation, throttling, and usage endpoint: MiniMax Token Plan FAQ, verified July 31, 2026.
• Special-model exclusions and what happens at quota exhaustion: MiniMax Token Plan overview, verified July 31, 2026.
• Subscription Key workflow and distinction from pay-as-you-go keys: MiniMax Token Plan quickstart, verified July 31, 2026.
• Credits prices, validity, and deduction order: MiniMax Token Plan pricing docs, verified July 31, 2026.
• Hermes installation and current MiniMax picker steps: MiniMax guide for Hermes Agent, verified July 31, 2026.
• Native provider ID, MINIMAX_API_KEY, hermes model, and configured-provider switching: Hermes Agent AI Providers, verified July 31, 2026.
• Refund statement for Token Plan: MiniMax referral-program terms, verified July 31, 2026.
• Paid-service, account-security, billing-change, and renewal caveats: MiniMax Terms of Service, effective March 30, 2026; verified July 31, 2026.