Suanlimao
← Back to all tutorials

Connect your tools

FastGPT

Add a model under FastGPT's System Models, then add an OpenAI-protocol channel for it.

About 8 minFor:Admins who self-host FastGPT

Before you start

  • A FastGPT admin account (recent versions ship with AI Proxy)
  • A key and a model name

Step 1 · STEP 0x01

Add the model

Admin → System resources → System models → Model config
1
Add model
2

Model type

LLM
3

Model provider

The closest match
4

Model id (model)

<MODEL_NAME>
5

Display name

Anything you like
6
Confirm
Diagram only — the real screen in your version may differ
  • Go to Admin → System resources → System models and click Add model at the top right of the Model config tab.
  • The model id must match the plaza exactly — channels match on it. Fill capabilities (context, function calling, vision) from the plaza.
  • If a built-in entry with the same name exists, you can simply enable it.
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 →

Step 2 · STEP 0x02

Add a channel

System models → Model channels → Add channel
1

Channel name

Anything, label only
2

Protocol

OpenAI
3

Models

Tick the model from step 1
4

Proxy address

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

API key

<YOUR_API_KEY>
6
Create
Diagram only — the real screen in your version may differ
  • Switch to the Model channels tab and click Add channel. Set the protocol to OpenAI and tick the model you just added.
  • Per the docs the proxy address must be the BaseUrl, not the full request URL — check whether /v1 is needed. For our service use https://api.suanlimao.shop/v1.
  • Leave model mapping empty, or use it to expose the model under a different name in apps.

Create a key →

Step 3 · STEP 0x03

Test and use it in an app

Model channels → Model test
1
Model test

Result

Each model shows pass / fail and latency

2

App → AI settings → Model

Your model
Diagram only — the real screen in your version may differ
  • Run Model test; once it passes, the model is selectable in an app's AI settings.
Older FastGPT versions configured models via llmModels in config.json and OneAPI environment variables; the current docs only describe the System models route and offer a OneAPI channel import. This tutorial follows the current version.

✓ How to tell it worked

  • Model test passes, app chats answer and the Usage page shows the requests.

FAQ

Model test fails?

Check the proxy address is https://api.suanlimao.shop/v1 (not a full request URL), the ticked model id matches the plaza, then the key and balance.

The model is not selectable in apps?

The model must be added / enabled under Model config and ticked in a channel — both are required.

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