Suanlimao
← Back to all tutorials

Getting started

Get started: top up, create a key, make a call

New here? Make your first request in about ten minutes.

About 10 minFor:Anyone using the service for the first time

Before you start

  • An email address that can receive a verification code
  • A payment method (the top-up page shows which ones are open)
  • A tool you want to connect, or a terminal window

Step 1 · STEP 0x01

Register and log in

Click “Get started”, enter your email, send the code, copy the 6-digit code from your inbox, choose a password and pass the human check.

Register
2
Send email code
3

Email code

6 digits
4

Password

At least 8 characters with letters and digits
5
Register
Diagram — the wording matches the real page, the layout may differ slightly

A new account starts with a zero balance and no trial credit, so top up next.

Step 2 · STEP 0x02

Top up

Open Billing in the console, pick an amount and a payment method, click Continue to payment and follow the page. The balance updates as soon as the payment lands.

Billing
1

Amount (USD)

Pick a preset or type an amount
2

Payment method

USDT (TRC20) / Alipay / WeChat (as shown on the page)
3
Continue to payment
Diagram — the wording matches the real page, the layout may differ slightly

Top up →

Step 3 · STEP 0x03

Create an API key

Open API keys, name the key and click Create key.

API keys
1

Name

e.g. my laptop
2

Budgets (USD, empty = unlimited)

5 hours / 1 day / 7 days / monthly / total
3
Create key
Diagram — the wording matches the real page, the layout may differ slightly
API keys

Copy it now — this is the only time the full key is shown.

<the full key appears here once>

1
Copy
Diagram — the wording matches the real page, the layout may differ slightly
The full key is shown only once, at creation. Missed it? Revoke it and create a new one.

Create a key →

Step 4 · STEP 0x04

Make your first request

Copy the command below into a terminal, replace <YOUR_API_KEY> with your key and <MODEL_NAME> with a model name copied from the model plaza.

terminal
$ curl https://api.suanlimao.shop/v1/chat/completions \    -H "Authorization: Bearer <YOUR_API_KEY>" \    -H "Content-Type: application/json" \    -d '{"model":"<MODEL_NAME>","messages":[{"role":"user","content":"Hello"}]}'{"choices":[{"message":{"role":"assistant","content":"Hello! …"}}], …}
Don't guess the model name: open the model plaza, click “Copy model id” on a model card and paste it. A wrong model name is the most common error.
Use https://api.suanlimao.shop/v1 as the API address (with /v1). If the tool says 404, check whether /v1 is missing or doubled, then read the FAQ below.

✓ How to tell it worked

  • The terminal prints JSON and choices holds the model's answer.
  • The request shows up on the Usage page and the balance drops slightly.

FAQ

I get 402 or insufficient_quota. Why?

Your balance is too low. New accounts start at zero, so top up first; the page also shows a minimum balance you need to keep.

I get 401 or invalid_api_key.

The key was copied incompletely, has an extra space, or was revoked. Check its status on the API keys page and create a new one if needed.

I get 404 model_not_found.

The model name is wrong or the model is not on sale yet. Copy the name from the model plaza and check the card says Available.

Which address should I use?

Use the first address shown; if it is unreachable, switch to the alternative. See the connection tutorial.

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