Suanlimao
← Back to all tutorials

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
Diagram only — the real screen in your version may differ
  • Open Settings → Model providers, click Add and choose a custom provider.
  • Set the API mode to OpenAI API Compatible.

Create a key →

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>
Diagram only — the real screen in your version may differ
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
Diagram only — the real screen in your version may differ
  • 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.

Open the model plaza →

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