Prerequisites
RuAPI account and API key
Console → Tokens → create an
sk-... key. The balance tops up in USDT — see Top-up.A running Open WebUI
Install per the Open WebUI docs (usually Docker).
Option 1: through the UI
Open connection settings
Admin Panel → Settings → Connections (or Settings → Connections for the current user).
Option 2: through environment variables
When starting the container, set:Verify
Start a new chat, pick a model (e.g.claude-opus-4-8) and send a message. A reply plus an entry in RuAPI Console → Logs means it works.
Troubleshooting
The model list is empty
The model list is empty
- Check the Base URL is
https://www.ruapi.ai/v1with/v1: models are fetched via/v1/models. - The key must be a RuAPI token (
sk-...).
401 / auth error
401 / auth error
The key is wrong or has spaces. Check its state in RuAPI Console → Tokens.
I want to keep both Ollama and RuAPI
I want to keep both Ollama and RuAPI
You can: Open WebUI supports several connections at once. Local Ollama models and cloud RuAPI models show up in the same picker.