Client Configuration

Any client that supports an OpenAI-compatible API can generally use the API base URL, API key, and model name provided through models.one.

General setup

1. Add a provider and select OpenAI Compatible, an OpenAI-compatible option, or a custom provider.
2. Enter the console-provided API base URL in Base URL.
3. Enter a key created for this client in API Key.
4. Enter the exact marketplace model name in Model.
5. Save the configuration and send a short test message.

Cherry Studio

The models.one homepage lists Cherry Studio. Labels can vary between releases. Look for an OpenAI-compatible or custom provider in the model service settings, then enter Base URL, API Key, and Model.

CC Switch

The homepage also lists CC Switch. Use the same base URL, key, and model-name pattern when creating or switching a configuration. Send one small request after saving to confirm that the selected profile is active.

Configuration checklist

• The base URL came from the console and does not duplicate /v1.
• The API Key has no leading/trailing spaces or line breaks.
• Model matches the marketplace identifier exactly.
• Local proxies, firewalls, and network rules allow access to the URL.
• The streaming option matches the capabilities of the client version.

Avoid these mistakes

• Do not expose the API key in screenshots, public configuration files, or shared repositories.
• Do not guess the API base URL from the models.one website domain.
• Do not change several settings at once while troubleshooting; isolate one variable at a time.