Model Service Settings

This document was translated from Chinese by AI and has not yet been reviewed.

This page only introduces the interface functions. For configuration tutorials, please refer to the Provider Configuration tutorial in the basic tutorials.

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

• Different service providers may use different names for the secret key, such as Secret Key, Key, API Key, Token, etc., all refer to the same thing.

API Key

In Cherry Studio, a single service provider supports multi-key round-robin usage, where the keys are rotated from first to last in a list.

• Add multiple keys separated by English commas, as shown in the example below:

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

You must use an English comma.

API Address

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

If the address provided by the service provider is in the format https://xxx.xxx.com/v1/chat/completions, you only need to fill in the root address part (https://xxx.xxx.com).

Cherry Studio will automatically concatenate the remaining path (/v1/chat/completions). Not filling it as required may lead to improper functionality.

Note: The large language model routes for most service providers are consistent, so the following operations are generally not necessary. If the service provider's API path is v2, v3/chat/completions, or another version, you can manually enter the corresponding version ending with "/" in the address bar; when the service provider's request route is not the conventional /v1/chat/completions, use the complete address provided by the service provider and end it with "#".

That is:

• When the API address ends with /, only "chat/completions" is concatenated.

• When the API address ends with #, no concatenation operation is performed; only the entered address is used.

Add Model

Typically, clicking the Manage button in the bottom left corner of the service provider configuration page will automatically fetch all models supported by that service provider. You can then click the + sign from the fetched list to add them to the model list.

Not all models in the pop-up list will be added when you click the Manage button. You need to click the + sign to the right of each model to add it to the model list on the service provider configuration page before it can appear in the model selection list.

Connectivity Check

Click the check button next to the API Key input box to test if the configuration is successful.

During the model check, the last conversation model added to the model list is used by default. If the check fails, please verify if there are any incorrect or unsupported models in the model list.

After successful configuration, make sure to turn on the switch in the upper right corner, otherwise, the service provider will remain disabled, and the corresponding models will not be found in the model list.