Suanlimao
← Back to all tutorials

Connect your tools

Zotero GPT

The GPT plugin for Zotero: enter the Base URL and key, pick a model.

About 5 minFor:Researchers who read papers in Zotero and want AI help

Before you start

  • Zotero with the Zotero GPT plugin installed
  • A key and a model name

Step 1 · STEP 0x01

Configure the chat model

Zotero GPT → Settings → Chat Model
1

Base URL

https://api.suanlimao.shop
2

Full URL

Unchecked
3

API Key

<YOUR_API_KEY>
4

Model selector

<MODEL_NAME>
Diagram only — the real screen in your version may differ
  • Follow the official docs: Base URL is the root address without /v1, https://api.suanlimao.shop, and leave Full URL unchecked so the plugin appends the path itself.
  • Enter the API Key, then choose the model from the plaza in the model selector.
The official walkthrough uses another relay as its example and states the same steps apply to “the official API or other relays”.
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.

Create a key →

Step 2 · STEP 0x02

Click Test to verify

Zotero GPT → Settings
1
Test

Result

Green “Normal, used …” means success

2
+ Save current config (optional)
Diagram only — the real screen in your version may differ
  • Click Test; a green Normal means success. Optionally save the configuration as a preset for quick switching.

Open the model plaza →

Step 3 · STEP 0x03

Embedding model (optional)

Zotero GPT → Settings → Embedding Model
1

API

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

API Key

<YOUR_API_KEY>
3

Model

An embedding model name from the plaza
Diagram only — the real screen in your version may differ
  • Only needed for full-text retrieval features. Note the API here is the full path https://api.suanlimao.shop/v1/embeddings, unlike the chat model.
Per the docs, model capability, compatibility, quota and cost depend on the service you use; a plugin licence is not a model subscription. Skip this step if the plaza lists no embedding model.

✓ How to tell it worked

  • Test shows Normal, questions about a paper get answers and the Usage page shows the request.

FAQ

Test fails?

Per the docs check balance, the selected configuration and network; then confirm the Base URL is the root address with Full URL unchecked.

A saved configuration does not show up?

Per the docs, close and reopen the settings window; if still missing, restart Zotero.

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