Token Plans
A Token Plan is a monthly model allowance from Baidu AI Cloud, sold on FluxA AgentMarket. You buy the plan on AgentMarket and receive one API key, issued by Baidu, that calls every model on the plan. Calls go to Baidu's endpoint directly, not through the AgentMarket router.
| Units (pay per call) | Token Plan (monthly) | |
|---|---|---|
| Where you call | https://router.fluxapay.xyz/llm/... | The plan's own baseUrl |
| Key | fxa_live_ key or Agent VC | The plan's key |
| Billing | Per token from your Units balance | A fixed monthly allowance of Token Plan Credits |
| Leftovers | Never expire | Do not roll over |
The two keys are not interchangeable: a plan key does not work on the router, and an fxa_live_ key does not work at the plan's endpoint.
Plans
| Plan | Price (USD) | Allowance |
|---|---|---|
lite | $18 | 20,000 Token Plan Credits, 1 month |
standard | $56 | 60,000 Token Plan Credits, 1 month |
advanced | $131.50 | 150,000 Token Plan Credits, 1 month |
Current prices, referral discounts and the model list are at agentmarket.fluxapay.xyz/marketplace/tokenplans/llms.txt.
Plans do not change tier. For a bigger allowance, buy another plan; each plan has its own key and allowance. Purchases are not refundable. Token Plan Credits are unrelated to Units and Monetize Credits.
All endpoints below accept Authorization: Bearer <fxa_live_ API key> or Bearer <Agent VC>. See API Keys & Auth.
Buy a plan
With USDC (agent)
POST https://router.fluxapay.xyz/llm/topup/paylink
Creates a FluxA Wallet payment link for the plan. Nothing is charged until a human opens the link and approves it.
{ "planSlug": "standard" }{
"orderId": "c27e...",
"planSlug": "standard",
"amount": 56,
"currency": "USDC",
"checkoutUrl": "https://...",
"statusUrl": "https://router.fluxapay.xyz/llm/topup/order/c27e..."
}Show the price to the user, give them checkoutUrl, then poll statusUrl. Referral codes do not apply to this link.
| Status | Meaning |
|---|---|
400 | Body is not JSON |
404 | Unknown plan |
409 | This account cannot hold a plan yet (code: "MISSING_UID"). Finish setting up the account on the website |
502 | The payment link could not be created. Try again |
CLI: fluxa-wallet market tokenplan buy standard
GET https://router.fluxapay.xyz/llm/topup/order/{orderId}
{
"status": "settled",
"plan": { "planSlug": "standard", "ready": true }
}Payment and plan setup are reported separately: a payment can be complete while the plan is still being set up.
| Field | Meaning |
|---|---|
status | Payment. pending = processing, settled = completed, failed = failed. Treat any other value as processing |
plan.ready | true when the plan's key is ready. false means setup is still in progress; poll again shortly |
CLI: fluxa-wallet market tokenplan order <orderId>
By card
Follow agentmarket.fluxapay.xyz/marketplace/tokenplans/topup.md. Humans can also buy on agentmarket.fluxapay.xyz/marketplace/tokenplans.
List your plans
GET https://router.fluxapay.xyz/llm/tokenplan/subscription
Every plan you hold, newest first.
{
"subscriptions": [
{
"id": "5d0c9b7e-...",
"planSlug": "standard",
"status": "active",
"creditsTotal": 60000,
"creditsUsed": 1250,
"creditsRemaining": 58750,
"periodStart": "2026-10-20T00:00:00Z",
"periodEnd": "2026-11-20T00:00:00Z",
"daysRemaining": 24,
"shared": false
}
]
}| Field | Meaning |
|---|---|
id | Subscription ID. Use it for the key and usage endpoints |
status | active = ready to use. expired / cancelled = ended. Any other value means the plan is still being set up |
creditsTotal / creditsUsed / creditsRemaining | This period's allowance in Token Plan Credits. null while the plan is being set up |
daysRemaining | Days left in the period. null while the plan is being set up |
shared | true for a plan claimed with a shared code (see below) |
CLI: fluxa-wallet market tokenplan list
Get the plan's key
GET https://router.fluxapay.xyz/llm/tokenplan/subscription/{id}/key
{ "apiKey": "<plan key>", "baseUrl": "https://..." }Use apiKey against baseUrl with any OpenAI-compatible client. How to call each model, and setup guides for coding tools: agentmarket.fluxapay.xyz/marketplace/tokenplans/baidu-ai-cloud/skill.md.
AgentMarket does not store the key; it is read from the provider each time you ask. Returns 404 for an unknown ID or a plan that is not yours.
CLI: fluxa-wallet market tokenplan key <id>
POST https://router.fluxapay.xyz/llm/tokenplan/subscription/{id}/key/rotate
Issues a new key and returns it in the same shape. The old key stops working immediately. Shared plans cannot be rotated (409, code: "SHARED_PLAN").
Check usage
GET https://router.fluxapay.xyz/llm/tokenplan/subscription/{id}/usage
| Param | Default | Description |
|---|---|---|
page | 1 | Page number |
pageSize | 20 | Max 100 |
Returns total and records[], one per call, with time, model, credits, inputTokens and outputTokens.
| Status | Meaning |
|---|---|
404 | Unknown plan, or not yours |
409 | The plan is still being set up, or it is a shared plan (code: "SHARED_PLAN"), whose usage is not reported per person |
CLI: fluxa-wallet market tokenplan usage <id>
Models on Token Plans
GET https://router.fluxapay.xyz/llm/tokenplan/models
{ "models": ["glm-5.3", "deepseek-v4-pro", "..."] }CLI: fluxa-wallet market tokenplan models
Redeem a code
Codes are one-shot and cannot be undone. Confirm with the user before using one.
POST https://router.fluxapay.xyz/llm/tokenplan/redeem
A redemption code gives you a plan of your own.
{ "code": "XXXX-XXXX-XXXX" }{ "status": "active", "subscriptionId": "5d0c9b7e-...", "planSlug": "fluxa-2" }If status is not active, the plan is still being set up; check it with the list endpoint shortly.
| Status | code | Meaning |
|---|---|---|
400 | BAD_CODE | Not a valid code format |
409 | CODE_UNUSABLE and others | The code was already used, expired, or is no longer valid |
409 | MISSING_UID | This account cannot hold a plan yet |
503 | — | Temporarily unavailable. The code was not used; try again shortly |
CLI: fluxa-wallet market tokenplan redeem <code> --yes
POST https://router.fluxapay.xyz/llm/tokenplan/shared/claim
A shared code gives you access to a plan that many people use together. Nothing is charged.
{ "code": "PROMO-CODE" }{ "status": "active", "subscriptionId": "5d0c9b7e-...", "alreadyClaimed": false }alreadyClaimed: true means you already held it and nothing changed. Errors: 400 BAD_CODE, 409 CODE_UNUSABLE.
CLI: fluxa-wallet market tokenplan claim <code> --yes
Common errors
| Status | Meaning |
|---|---|
401 | Missing, invalid or expired credential. error explains what to fix |
403 | Account suspended |
503 | The sign-in service is temporarily unavailable. Retry shortly |
See also CLI: AgentMarket.
