Prerequisites
RuAPI account + API key
sk-... key.deepseek-flash model, check); then, in “Add RuAPI as a provider”, only the last step is left: choosing default models.
Console → API Keys: the “Connect Claude Code, Cline & more” button

The “Connect an app” window with Cherry Studio selected: the address and key are filled in (key hidden in the screenshot)
Install Cherry Studio
Download from cherry-ai.com or GitHub Releases:- Windows
- macOS
- Linux
Cherry-Studio-Setup-x.y.z.exe and run the installer.Add RuAPI as a provider
These steps and screenshots are for Cherry Studio 2.1.6 (October 2026). Button names may differ slightly in other versions.Open the add-provider form
Fill in the form
https://www.ruapi.ai/v1/chat/completions, which means the address is right. You can leave the Anthropic field empty. Click Add.
The new provider form: name, key and OpenAI address
Add the deepseek-flash model
deepseek-flash in Model ID (Model Name and Group Name fill in with the same value automatically) and click Add Model.deepseek-flash, claude-haiku-5-5 and gpt-6-luna. Once you top up $5 or more, add other models with Sync models — just tick them in the list. Prices for every model are on the pricing page.
Adding the model: Model ID is deepseek-flash
Check and enable

Checking deepseek-flash
deepseek-flash model.
The RuAPI provider is set up and enabled
Choose default models
deepseek-flash under RuAPI — the other two fields fill in with the same model. Click Get Started.
All three default models are deepseek-flash
First call
Open Chat (the speech-bubble icon on the left), click the model name at the top and pick a model under RuAPI. Send:Default model choices
Settings → Default Model:- Default Assistant Model: everyday chat. Recommend the GPT family or Claude Sonnet.
- Quick Model: simple tasks such as naming conversations and extracting search keywords. A cheap model like Claude Haiku is enough.
- Translate Model: GPT mini or Claude Haiku work well.
deepseek-flash under RuAPI in these fields: by default Cherry Studio uses its own built-in model, not RuAPI.
Troubleshooting
401 / authentication failed
401 / authentication failed
- The API key must be a RuAPI key (
sk-...), not an OpenAI key. - Watch for trailing whitespace.
- Check the key in RuAPI Console → API Keys.
Model not found (503) or 404
Model not found (503) or 404
- Model ID typo. When you add a model by hand, Model ID must match RuAPI exactly (for example
deepseek-flash), with no spaces before or after. For other models, it’s easier to click Sync models and tick them in the list. - Don’t append
/chat/completionsto the API host —https://www.ruapi.aiis enough.
Streaming is choppy / slow
Streaming is choppy / slow
- Check network stability.
- Try disabling streaming in settings to compare.
Function calling / tools don't work
Function calling / tools don't work
Image input fails (vision)
Image input fails (vision)
deepseek-flash understand images; GLM models are text-only — see vision.Run RuAPI alongside other providers
Run RuAPI alongside other providers
Advanced
- Knowledge base: Cherry Studio’s built-in RAG needs an embedding model. RuAPI offers
text-embedding-3-smallandtext-embedding-3-large: add one to the RuAPI provider with the ”+” button like any other model (by ID; if Cherry Studio does not detect the type itself, mark it as an embedding model), then pick it when you create the knowledge base. Embedding models unlock after a top-up. If your documents must not leave your computer, use a local embedding model (for example via Ollama) and keep chat on RuAPI. - Agents: Cherry Studio’s agent system runs client-side and calls your configured provider. The Claude Sonnet or GPT families make solid agent backbones.
- Multiple keys: if one key isn’t enough, create several with separate limits in the RuAPI Console and bind them to different Cherry Studio profiles.