Connect your tools
RAGFlow
Add an OpenAI-API-compatible provider under RAGFlow's Model providers.
About 6 minFor:Admins who self-host RAGFlow for document Q&A
Before you start
- RAGFlow is deployed and you can sign in
- A key and a model name
Step 1 · STEP 0x01
Choose a provider
Available models
Instance name
Go to User settings → Model providers, pick the OpenAI-API-compatible provider under Available models and name the instance. The Chinese UI uses the equivalent labels; follow your version.
Step 2 · STEP 0x02
Enter the key and Base URL, then add a model
API Key
Base URL
Model name (custom model)
Model type
Max context length (optional)
Tool calling (optional)
- Base URL is
https://api.suanlimao.shop/v1. The docs say to “confirm whether the path must include /v1” for compatible APIs — ours does. - When adding a custom model the docs require the name to match the model ID exposed by the provider API — the name on the plaza.
- Saving runs a verification; on failure a warning marker appears — open it for the error.
Step 3 · STEP 0x03
Set as default and test
Chat model
Chat assistant → test
- Point the Chat model in system model settings to it and try a question in a chat assistant.
✓ How to tell it worked
- The provider verifies, chat assistants answer and the Usage page shows the request.
FAQ
Verification fails?
The docs' order: credentials, endpoint (is /v1 present), model name, service availability, quota. Check each and verify again.
Chat works but parsing documents is slow?
Parsing uses embedding and OCR models, not the chat model; check those configurations.
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).