Model Service Settings

This page only introduces the interface functions; for configuration tutorials, please refer to the Provider Configuration tutorial.

• When using built-in providers, you only need to fill in the corresponding secret key.

• Different providers may use different names for the secret key; secret key, Key, API Key, token, etc. all refer to the same thing.

API Key

In Cherry Studio, a single provider supports multi-Key polling use, and the polling method cycles through the list from front to back.

• Use an English comma to separate multiple Keys. For example:

sk-xxxx1,sk-xxxx2,sk-xxxx3,sk-xxxx4

Must use English comma.

API Address

When using built-in providers, you generally do not need to fill in the API address. If you need to modify it, please strictly follow the address given in the provider's official documentation.

If the address given by the provider is https://xxx.xxx.com/v1/chat/completions in this format, only fill in the root address part (https://xxx.xxx.com) is enough.

Cherry Studio will automatically append the remaining path (/v1/chat/completions), and failing to fill it in as required may cause it to not work properly.

Note: The large language model routes of most providers are unified, and in general the following operations are not necessary. If the provider's request route is not the usual /v1/chat/completions when, you can manually enter the complete API addressin the API address bar, and end it with #.

That is:

• When the API address ends with # no concatenation will be performed; only the entered address will be used.

Add Model

In general, clicking the Manage button at the bottom left of the provider configuration page will automatically fetch all models supported by that provider. Click the + button in the fetched list to add them to the model list.

When you click the Manage button, not all models in the popup list will be added. You need to click the + on the right side of the model to add it to the model list on the provider configuration page before it can appear in the model selection list.

Connectivity Check

Click the check button after the API Key input box to test whether the configuration was successful.

When checking models, the last chat model already added to the model list is used by default. If the check fails, please verify whether the model list contains incorrect or unsupported models.

After the configuration is successful, be sure to turn on the switch in the upper right corner; otherwise, the provider will still be in an inactive state and its corresponding model cannot be found in the model list.