Cherry Studio Integration

Documentation maintained by 1ZheAI. Sources and corrections.

Found an error? Contact support with the page address and a description. Do not send API keys or account credentials.

Cherry Studio is a desktop AI chat client where you can add 1折AI as a custom provider.

One-Click Import

In the console, under API Keys → Tools → Cherry Studio, select the Anthropic or OpenAI protocol and click Open Cherry Studio. After confirming the import in the app, fetch the models, enable the provider, and test it. If a configuration with the same name already exists, check the overwrite prompt. The import link contains the full key — do not forward it.

The browser cannot confirm whether the app is installed. If it does not launch, install and start the client once first, or use the manual steps below. The protocol format has been checked against the official implementation, but actual inference still needs to be verified against your specific version and model.

Configuration

1. Add a provider

   Settings (gear icon) → Model Services → + Add Provider at the bottom of the list.

2. Fill in the details

   Field	What to enter
   Provider Name	1折AI
   API Key	sk-你的Key
   Endpoint	Select Anthropic (recommended) or OpenAI
   API Address	https://1zheai.com

   Enter only the base URL in the API Address field; Cherry Studio will automatically append /v1/... based on the selected protocol. Do not paste full paths like /v1/messages or /v1/chat/completions, and do not add # at the end (a trailing # means no path will be appended automatically).

3. Add a model

   Click Get Model List and add the models you want to use from the returned list; or click + to manually enter a model ID, such as claude-sonnet-5-5. Only models added to the list will appear in the model selector in the chat.

4. Enable and test

   Turn on the enable toggle in the top-right corner of the provider page, return to the chat interface, and send a message using a model under 1折AI.

Choosing the Anthropic or OpenAI Endpoint

Endpoint	Best for
Anthropic	Using Claude-native capabilities such as extended thinking; refer to the current version for the Agent’s protocol restrictions
OpenAI	Being used to the OpenAI format, or managing alongside other OpenAI-compatible services

Both endpoints use the same API key and the same set of model IDs.

FAQ

Fetching the model list failed?

First check whether the API key has extra spaces; then confirm the API address is https://1zheai.com with no extra path written. If you cannot fetch the list, it does not affect usage — manually entering a model ID also works.

Chat returns 404?

The API address was entered as a full path, or # was added at the end. Change it back to the base URL https://1zheai.com.