---
title: Cherry Studio 接入
description: 在 Cherry Studio 添加 1折AI 为自定义服务商，选 Anthropic 或 OpenAI 端点，填根地址、API 密钥和模型。
---

Cherry Studio 是桌面端的 AI 对话客户端，可以把 1折AI 添加成一个自定义服务商。

## 配置

<Steps>
<Step title="添加服务商">

设置（齿轮图标）→ **模型服务** → 列表下方的 **+ 添加服务商**。

</Step>
<Step title="填写信息">

| 字段 | 填什么 |
|---|---|
| 提供商名称 | `1折AI` |
| API 密钥 | `sk-你的Key` |
| 端点 | 选 **Anthropic**（推荐）或 **OpenAI** |
| API 地址 | `https://1zheai.com` |

API 地址只填根地址，Cherry Studio 会按所选协议自动补上 `/v1/...`。不要把 `/v1/messages`、`/v1/chat/completions` 这类完整路径粘进去，也不要在末尾加 `#`（`#` 结尾表示不再自动补路径）。

</Step>
<Step title="添加模型">

点 **获取模型列表**，从返回的列表里添加要用的模型；或者点 **+** 手动输入模型 ID，比如 `claude-sonnet-5-5`。只有加进列表的模型才会出现在对话的模型选择里。

</Step>
<Step title="启用并测试">

打开服务商页面右上角的启用开关，回到对话界面，选 1折AI 下的模型发一条消息。

</Step>
</Steps>

## 选 Anthropic 还是 OpenAI 端点

| 端点 | 适合 |
|---|---|
| Anthropic | 想用 extended thinking 等 Claude 原生能力；Cherry Studio 的 Agent 功能也要求 Anthropic 协议 |
| OpenAI | 习惯 OpenAI 格式，或要和其他 OpenAI 兼容服务统一管理 |

两种端点用的是同一个 API 密钥（API key）和同一套模型 ID。

## 常见问题

<AccordionGroup>
<Accordion title="获取模型列表失败？">

先检查 API 密钥有没有多余空格；再确认 API 地址是 `https://1zheai.com`，没有多写路径。获取不到也不影响使用，手动输入模型 ID 也能用。

</Accordion>
<Accordion title="对话报 404？">

API 地址写成了完整路径，或者末尾加了 `#`。改回根地址 `https://1zheai.com`。

</Accordion>
</AccordionGroup>