Cherry Studio Custom API Setup with Sprelay
Cherry Studio is a desktop chat and knowledge-base client. Connect Sprelay as an OpenAI-compatible provider.
One-click setup
- Install and open Cherry Studio.
- Open Sprelay API Keys.
- Open the action menu for a dedicated Cherry Studio key.
- Select the Cherry Studio import action when available.
- Approve the browser prompt only after confirming the target application.
- In Cherry Studio, review the URL, key, and model list.
Manual setup
Add an OpenAI-compatible provider with these values:
| Field | Value |
|---|---|
| Provider name | Sprelay API |
| API key | A dedicated Sprelay key |
| API URL | https://sprelaytoken.com/v1 |
| Model | An exact ID from the model catalog or GET /v1/models |
Save the provider and run its connection check. If model sync is unavailable, add the exact model ID manually. A display label may be customized, but the ID sent to the API must not be changed.
For a 401, recopy the complete key and check its status and quota. For a 404, verify that the URL is not /v1/v1 and does not contain the full /chat/completions path twice.
Choose a model and verify billing
Sprelay currently lists gpt-6.1-sol, gpt-6-astra and claude-fable-5-1 with OpenAI-compatible endpoints. Availability depends on the key's group. Check the live catalog instead of assuming that every key can use every model.
Send a short message, then open usage logs to confirm the model, response status and charge. Set a small quota before testing long conversations or knowledge-base requests. See billing for input, output and cache costs.
If a direct first API request succeeds but Cherry Studio fails, review the provider type, exact model ID and generated request URL. See client connection troubleshooting and Cherry Studio's provider documentation.
