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.
Email code
Password
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.
Amount (USD)
Payment method
Step 3 · STEP 0x03
Create an API key
Open API keys, name the key and click Create key.
Name
Budgets (USD, empty = unlimited)
Copy it now — this is the only time the full key is shown.
<the full key appears here once>
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.
$ 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! …"}}], …}
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
choicesholds 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).