Agent · referral · supply
Agent: activation, agent prices and sub-keys
Pay from one agent balance and issue sub-keys to your own customers — from applying to managing sub-keys, in one guide.
About 12 minFor:Users who want to resell capacity to their own customers
Before you start
- A signed-in regular account (you apply from your own account; there is no separate sign-up)
- Whether the program is open, the first-top-up threshold, the minimum per later top-up and the agent ratio: always go by the Agent page in the console
- Read the agent terms on the page first
Step 1 · STEP 0x01
Understand what an agent is
Agent terms
Threshold, agent price, sub-key rules, no refunds…
I have read and accept the agent terms
- Agent price = retail price × agent ratio; the ratio is currently 1, so agent prices equal retail — no discount. You set what you charge your customers; the difference is your margin.
- Sub-keys can only call the API and cannot sign in. Your customers are not platform users; the platform does not know them.
- The agent balance is fully separate from your retail wallet; no transfers either way.
- Promo codes cannot be used on agent top-ups and earn no commission.
- Reaching the threshold activates agent status; applications are not rejected. Top-ups are non-refundable; if agent status is revoked, the agent balance is frozen and top-ups and sub-key actions are unavailable.
Step 2 · STEP 0x02
Apply and complete the first top-up
Amount (USD)
Payment method
Status card
Applied — waiting for your first top-up / Under review / Agent account active
- Accept the terms, click Apply to become an agent, then top up as the page instructs.
- Once credited top-ups reach the threshold the status becomes Under review; the account is activated after manual approval. You can keep topping up meanwhile.
- For offline payments, finance issues agent codes that you redeem on the Agent page; they credit the agent balance. Retail codes cannot be redeemed there.
Step 3 · STEP 0x03
After activation: read the agent price list
Two price columns
Retail · Agent price
Prices are in USD per 1M tokens. How you price your own customers is up to you and is not shown anywhere.
Step 4 · STEP 0x04
Create sub-keys in bulk
Quantity
Note
Limits (optional)
Step 5 · STEP 0x05
Manage sub-keys
Search by note
List
Note · Key prefix · Status · This month · Total · Last used · Limited
- Disable / Enable: temporarily cut a customer off and restore any time (keys disabled by operations or risk control cannot be re-enabled by you).
- Reset: the old key stops working immediately and the new one is shown only once; each key can be reset a limited number of times per day, as the page states.
- Delete (archive): the key is voided immediately and cannot be restored; usage records are kept.
- You can change the note and limits at any time; changes apply to new requests.
Step 6 · STEP 0x06
Check usage and balance
From / To
Sub-key id (optional)
Results
Spend by sub-key, by model and by day
You get an email when the agent balance drops below the amount shown on the page — top up in time. The agent ledger lists top-ups, usage charges, billing adjustments, manual credits or debits and redeemed codes.
✓ How to tell it worked
- The Overview shows “Agent account active”, and the Agent prices and Sub-keys tabs are visible.
- Send one request with a sub-key: it appears under Usage and the agent balance goes down accordingly.
FAQ
My customer's sub-key reports “service quota exhausted”.
Errors returned to sub-keys never show the platform brand or a top-up link; insufficient balance always reads “service quota exhausted, contact your provider”. It means your agent balance is too low — top up on the Agent page.
Can my customers sign in to the platform?
No. Sub-keys only call the API; they have no account or email and cannot sign up or recover anything.
Can I use a sub-key myself?
Yes, but it is billed to the agent balance. For your own day-to-day use, a key from your retail account is the better choice.
The page says agent status is not active.
Please contact support.
My agent status was revoked.
The Agent menu disappears and the balance is frozen. By default all your sub-keys are disabled, though operations may choose to keep them running for a while.
Related tutorials
Still stuck?
Read the troubleshooting tutorials first. If that does not help, open a ticket with the request_id, time, model and the exact error (never paste your key).