Suanlimao
← Back to all tutorials

Connect your tools

Open WebUI

As an admin, add an OpenAI-compatible connection under Connections.

About 5 minFor:Admins who run their own Open WebUI

Before you start

  • An Open WebUI admin account
  • An API key

Step 1 · STEP 0x01

Open Connections

Settings > Connections

Manage OpenAI API Connections

1
Add Connection
Diagram only — the real screen in your version may differ
  • As an admin open Settings > Connections.
  • Under Manage OpenAI API Connections click Add Connection.

Create a key →

Step 2 · STEP 0x02

Enter the URL and key

Add Connection
1

URL

https://api.suanlimao.shop/v1
2

API Key

<YOUR_API_KEY>
3
Verify Connection
4
Save
Diagram only — the real screen in your version may differ
  • Leave Provider under Advanced at Default.
  • Model IDs normally stay empty: if the service supports /models they are detected; otherwise type each id and click +.
  • Click Verify Connection — success shows “Server connection verified.” — then Save.
A 400, 401 or 403 on verification does not always mean the connection is broken; some services do not support the /models check. Add a model id by hand and test a chat instead.

Step 3 · STEP 0x03

Pick a model and chat

Chat
1

Model selector

A model from this connection
2

Message box

Hello
Diagram only — the real screen in your version may differ
  • Each connection has a toggle to disable it without deleting.
  • Pick a model from this connection in the chat model selector.

Open the model plaza →

✓ How to tell it worked

  • Chat answers normally and the Usage page shows the request.

FAQ

No models in the selector.

Add the names copied from the model plaza under Model IDs.

Open WebUI runs in Docker and cannot reach us.

Our address is public so this normally works; make sure the container has internet and DNS access.

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