---
title: "Cherry Studio Integration"
description: "Add 1折AI as a custom provider in Cherry Studio by choosing the Anthropic or OpenAI endpoint and entering the base URL, API key, and models."
headingIds: {"One-Click Import":"section-1","Configuration":"section-2","Choosing the Anthropic or OpenAI Endpoint":"section-3","FAQ":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentation maintained by [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Sources and corrections](https://1zheai.com/en/editorial/).

Found an error? [Contact support](mailto:support@1zheai.com) with the page address and a description. Do not send API keys or account credentials.

</aside>
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

<Steps>
<Step title="Add a provider">

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

</Step>
<Step title="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).

</Step>
<Step title="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.

</Step>
<Step title="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.

</Step>
</Steps>

## 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

<AccordionGroup>
<Accordion title="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.

</Accordion>
<Accordion title="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`.

</Accordion>
</AccordionGroup>