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>
- 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.
Step 2 · STEP 0x02
Click Test to verify
Zotero GPT → Settings
1
Test
Result
Green “Normal, used …” means success
2
+ Save current config (optional)
- Click Test; a green Normal means success. Optionally save the configuration as a preset for quick switching.
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
- 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
Obsidian Copilot pluginAdd a custom provider in Obsidian's Copilot plugin (works on the free tier).PDFMathTranslate (pdf2zh)The paper translator that keeps formula layout: three environment variables.Can't connect, broken streams, which address to useA step-by-step check for requests that do not go out, time out or break mid-stream.
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).