Prerequisites
- You have completed Create an account.
- You have completed Get an API Key.
- Cherry Studio is installed and its settings page opens normally.
- You have the 4096bytes API Key, Base URL, and model name.
cherry-studio-home or cherry-studio-work.
Install
If Cherry Studio is not installed, open the Cherry Studio download page and choose the package for your system.Download the package
Choose Windows, macOS, or Linux from the official download page. Windows users may need to choose between installer and portable builds. macOS users should choose Intel or Apple Silicon correctly.
Launch Cherry Studio
Open Cherry Studio once after installation and confirm the main window starts normally.
Add a provider
Open settings
Launch Cherry Studio and open Settings. The entry point may be in the lower-left corner or sidebar.
Fill connection fields
| Cherry Studio field | Value |
|---|---|
Name, Provider name | 4096bytes |
API Key, Key | The API Key you created in the 4096bytes dashboard. |
API address, API Host, Base URL | https://api.4096bytes.com. |
API type, Compatible type | OpenAI compatible. |
Model, Model name | The model name shown in the dashboard. |
/v1/chat/completions, /v1/responses, or another full endpoint path.
Add models
Cherry Studio versions differ in how they handle model lists. Some can fetch models automatically; others require manual model names.Add a model manually
If the model list is empty, click Add model or Custom model and enter the model name shown in the dashboard.
Test connection
After saving, create a new chat in Cherry Studio and select a model under the 4096bytes provider. Use a short test prompt:Tips
- Use a dedicated API Key for Cherry Studio.
- If multiple providers are configured, check the selected model before sending a message.
- If Cherry Studio supports model groups or default models, set your common 4096bytes model as the default.
- Avoid personal keys on shared team devices. If sharing is necessary, use a separate key with a quota limit.
Troubleshooting
Connection test failed
Connection test failed
Confirm the provider type is OpenAI compatible, then check API Key, Base URL, and model name. Use
https://api.4096bytes.com and do not fill a full endpoint path.Model list is empty
Model list is empty
If Cherry Studio cannot fetch models automatically, add the model name from the dashboard manually. Save the provider and reopen the chat.
Authentication failed
Authentication failed
Check whether the API Key is complete and copied without extra spaces or newlines. Confirm the key was not deleted, expired, or over quota.
model not found
model not found
Copy the model name again from the dashboard. It must match exactly and must not come from another client page or old screenshot.
The chat uses another provider
The chat uses another provider
Check the current chat’s model selector. Cherry Studio may keep the last used model, so switch to the 4096bytes provider manually.
Requests are slow or interrupted
Requests are slow or interrupted
Start with a short prompt. Long context, attachments, proxy networks, and concurrent requests can affect response time. Check Cherry Studio logs if needed.