Suanlimao
← Back to all tutorials

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 → Overview

Agent terms

Threshold, agent price, sub-key rules, no refunds…

1

I have read and accept the agent terms

Checked
2
Apply to become an agent
Diagram — the wording matches the real page, the layout may differ slightly
  • 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.
This is a summary of the rules. The actual figures (threshold, ratio, daily key limit) may change; the agent terms on the page are authoritative.

Step 2 · STEP 0x02

Apply and complete the first top-up

Agent → Overview
1

Amount (USD)

You are activated once credited top-ups reach the threshold; several payments are fine
2

Payment method

Same payment methods as retail
3
Pay

Status card

Applied — waiting for your first top-up / Under review / Agent account active

Diagram — the wording matches the real page, the layout may differ slightly
  • 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.

Top up →

Step 3 · STEP 0x03

After activation: read the agent price list

Agent → Agent prices
1

Two price columns

Retail · Agent price

Diagram — the wording matches the real page, the layout may differ slightly

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

Agent → Sub-keys
1

Quantity

1 up to the limit shown
2

Note

Customer name, so you can find it later
3

Limits (optional)

5-hour / 1-day / 7-day / monthly / total budgets, RPM, allowed models
4
Create keys
Diagram — the wording matches the real page, the layout may differ slightly
New keys (shown only once)
1
Copy all
2
Download .txt
3
Saved, close
Diagram — the wording matches the real page, the layout may differ slightly
The full keys are shown only once; after closing they can never be shown again. Copy or download them before handing them to your customers. Re-submitting the same request does not create new keys and does not show the full keys again.

Step 5 · STEP 0x05

Manage sub-keys

Agent → Sub-keys
1

Search by note

List

Note · Key prefix · Status · This month · Total · Last used · Limited

2
Disable / Enable
3
Reset
4
Delete
Diagram — the wording matches the real page, the layout may differ slightly
  • 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.
For 24 hours after a password change, password reset or re-binding, the Agent page is read-only: no creating, disabling, resetting or deleting sub-keys. Sub-keys with no calls for 90 days are archived automatically.

Step 6 · STEP 0x06

Check usage and balance

Agent → Usage
1

From / To

2

Sub-key id (optional)

Results

Spend by sub-key, by model and by day

Diagram — the wording matches the real page, the layout may differ slightly

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).