Cherry Studio
Connect Cherry Studio to Yolo Router and add available models manually.
- Cherry Studio is installed and can open normally.
- A working Yolo Router endpoint, for example
https://api.yolorouter.com. - A Yolo Router API Key generated from the console.
- The model ID you want to use, for example
deepseek-v4-pro. It must exactly match the model ID in the Yolo Router console.
Cherry Studio custom providers build request paths from the selected provider type. For OpenAI-compatible APIs, choose the
OpenAItype and confirm the final request reaches Yolo Router's/v1/chat/completions.
Setup
Verify Yolo Router first
Before configuring Cherry Studio, verify that the endpoint, API Key, and model ID work.
export YOLOROUTER_API_KEY="sk-yolo-..."
curl https://api.yolorouter.com/v1/models \
-H "Authorization: Bearer $YOLOROUTER_API_KEY"$env:YOLOROUTER_API_KEY = "sk-yolo-..."
curl.exe https://api.yolorouter.com/v1/models `
-H "Authorization: Bearer $env:YOLOROUTER_API_KEY"If the model list is returned, confirm that the model ID you plan to add to Cherry Studio exists, for example deepseek-v4-pro.
Add a custom provider
Open Cherry Studio and go to:
Settings > Model ServicesClick + Add, create a custom provider, and enter:
Provider Name: for exampleYolo RouterProvider Type: selectOpenAI
Save it, then find the new Yolo Router provider in the model services list.
Enter the API Key and API address
In the Yolo Router provider configuration, enter your API Key:
sk-yolo-...Choose the API address format based on your Cherry Studio version:
- If the field is
API Addressand Cherry Studio automatically appends/v1/chat/completions, enter the root address:https://api.yolorouter.com - If the field is
Base URLorOpenAI Compatible Base URL, enter the full OpenAI-compatible address:https://api.yolorouter.com/v1
Do not enter /chat/completions unless your Cherry Studio version explicitly asks for a full request URL and supports using # to disable automatic path appending.
Add the model
In the provider configuration, click Manage or + Add, then add the model ID you want to use:
deepseek-v4-proThe model ID must exactly match the model ID in the Yolo Router console. After adding it, confirm that it appears in the provider's model list.
Check and enable the provider
Click the Check button next to the API Key to verify the connection.
After the check succeeds, turn on the provider switch in the top-right corner. If the provider is disabled, Cherry Studio may not show the provider or its models in the chat model list.
Test in chat
Return to the chat page, select the Yolo Router provider and the model you added, then send a test prompt:
Introduce the model you are using in one sentence.If Cherry Studio returns a normal response, the integration is working. You can also check the Yolo Router console for the corresponding request log.
Troubleshooting
Check fails
Check these first:
- The API Key is correct and has no extra spaces
- The API address is not duplicating
/v1 - The last conversational model in the provider model list is actually available
The model does not appear in the model list
Confirm that the model ID was added in provider model management, and that the provider switch in the top-right corner is enabled.
Should the API address include /v1?
It depends on the field behavior in your Cherry Studio version. If Cherry Studio automatically appends /v1/chat/completions, enter the root address. If it explicitly asks for an OpenAI-compatible Base URL, enter the address with /v1.
Multiple API keys
Cherry Studio supports multiple keys in one provider. Separate them with English commas:
sk-yolo-1,sk-yolo-2,sk-yolo-3