Connect your tools
Chatbox
A desktop and mobile chat client: add a custom model provider.
About 5 minFor:People who chat in Chatbox
Before you start
- Chatbox is installed
- A key and a model name
Step 1 · STEP 0x01
Add a custom provider
Settings → Model providers
1
Add
2
API mode
OpenAI API Compatible
3
Name
Anything you like
- Open Settings → Model providers, click Add and choose a custom provider.
- Set the API mode to OpenAI API Compatible.
Step 2 · STEP 0x02
Enter the API host and key
Custom provider
1
API host
https://api.suanlimao.shop
2
API path
Empty = default /v1/chat/completions
3
API key
<YOUR_API_KEY>
Per Chatbox's docs the API path can usually stay empty — the default is
/v1/chat/completions — so the host is the root address https://api.suanlimao.shop without /v1. If your version shows /chat/completions as the default path, use https://api.suanlimao.shop/v1 as the host instead. Follow the path your screen shows.Step 3 · STEP 0x03
Add a model and check
Custom provider
1
Model
<MODEL_NAME>
2
Check
- Add at least one model; capability options can stay empty, in which case it is treated as a text-only model.
- Click Check — a success message means it works.
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.
✓ How to tell it worked
- Start a chat, pick the model and get a reply.
FAQ
Check says 404.
Usually /v1 is missing or doubled — see step 2.
Check says 401.
The key is incomplete or revoked.
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).