# Cherry Studio (/docs/cookbook/chat-clients/cherry-studio)











把 Praxis 接入 Cherry Studio，用一个 Key 聊所有模型——全程不写代码。

每一步都标了**期望结果**：照做即可，也可以把本页直接交给能操作电脑的 AI 助手，让它替你完成配置与验证。

## 你将完成 [#你将完成]

* 在 Cherry Studio 里直接使用 Praxis 的模型对话
* 完成标志：向 `deepseek-flash` 发送「你好」并收到回复
* 预计耗时：**5 分钟**（不含下载安装）
* 支持协议：OpenAI 兼容（本页路线）/ Anthropic 兼容（见[进阶](#进阶)）

## 前提 [#前提]

开始前逐项确认：

* **一个 Praxis API Key**（`sk-praxis-` 开头）。没有就到 [控制台 → API Keys](https://console.deepraxis.ai/keys) 创建：点「创建 Key」，弹窗中**名称必填**，有效期默认 90 天（可改永久），点创建后立即复制保存；之后也随时可在 Key 列表行点「复制」重新获取完整 Key。新账号自带 **$1 免费额度**，跑完本页绰绰有余。完整流程见[快速开始](/docs/cloud/services/model/quickstart)。
* **Cherry Studio 已安装**。从[官网](https://cherry-ai.com)下载（自动匹配系统），或到 [GitHub Releases](https://github.com/CherryHQ/cherry-studio/releases) 手选：Windows 选 `-setup.exe`（安装版）或 `-portable.exe`（免安装）；macOS 选 `.dmg`（Intel 芯片选 x64，Apple 芯片选 arm64）；Linux 选 `.AppImage`（下载后 `chmod +x` 加执行权限再运行）。
* **首次启动**：先选语言（默认 English，可切中文），欢迎页点「稍后设置」跳过登录即可使用。
* 本页以 v2.1.4 界面为准，菜单位置可能随版本微调。

## 配置 [#配置]

**第 1 步：打开模型服务设置**

主界面左下角的齿轮图标「设置」，再点左侧菜单「模型服务」。

期望：右侧出现提供商列表（OpenAI、硅基流动、智谱开放平台……）。

<img alt="设置入口：左下角齿轮进入设置，左侧菜单选「模型服务」，右侧是提供商列表" src="__img0" />

**第 2 步：添加服务商，一次填齐名称、密钥、地址**

点提供商列表底部的「添加服务商」按钮，弹窗「添加自定义提供商」里填三处：

| 字段                | 填什么                                  |
| ----------------- | ------------------------------------ |
| 提供商名称（必填）         | `Praxis`（显示名，可任取）                    |
| API 密钥            | `sk-praxis-` 开头的你的 Key               |
| 端点设置 → OpenAI 根地址 | `https://api.deepraxis.ai/openai/v1` |

地址必须**以 `/v1` 结尾**——弹窗会实时显示「请求路径」预览，看到 `…/openai/v1/chat/completions` 即为正确。填完点「添加」。

期望：提供商列表末尾出现 Praxis 条目，卡片上密钥显示为掩码。

<img alt="添加自定义提供商弹窗：名称填 Praxis，密钥与 OpenAI 根地址已填，下方显示请求路径预览" src="__img1" />

**第 3 步：添加模型**

添加成功后，Cherry Studio 会**自动拉取 Praxis 的模型目录**并弹出「选择模型」对话框。在列表中勾选 `deepseek-flash`——平台示例模型：便宜、快、中英文都好——点「添加所选模型」，应用会自动检测并启用。

期望：模型出现在 Praxis 的模型列表中，启用开关为开。

<img alt="选择模型对话框：自动拉取的模型目录中勾选 deepseek-flash" src="__img2" />

拉取失败或列表为空时，点 Praxis 卡片上的「手动添加模型」，模型 ID 填 `deepseek-flash`，其余留空即可。

## 验证 [#验证]

回到对话页，点**右上角的模型选择器**，切到 Praxis 下的 `deepseek-flash`，发送「你好」。

期望：几秒内收到一段中文回复——**收到回复即接入成功**。

<img alt="对话页收到第一条回复：模型选择器显示 DeepSeek V4.1 Flash | Praxis" src="__img3" />

也可以在命令行完成等价验证。先设置变量（不然照抄 curl 会得到 401）：

```bash
export PRAXIS_API_KEY=sk-praxis-你的Key
```

以下命令为 macOS / Linux / WSL（bash）写法。Windows PowerShell 用户：界面已收到回复即接入成功，可跳过；如需命令行验证，先执行 `$env:PRAXIS_API_KEY="你的Key"`，再把 curl 写成一行（去掉每行末尾的 `\`）。

```bash
curl https://api.deepraxis.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer $PRAXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-flash", "messages": [{"role": "user", "content": "你好"}]}'
```

期望：返回 HTTP 200，`choices[0].message.content` 是一段中文回复（响应里出现 `reasoning` 字段也正常——那是推理模型的思维链）。返回 `401` 是密钥问题，报「模型不存在」是 ID 拼写问题——对照下方常见问题。

最后看一眼 [控制台 → 用量与费用](https://console.deepraxis.ai/usage)：刚才的调用已经记在账上——每一次调用都有账、可追溯。

## 常见问题 [#常见问题]

| 症状                                  | 原因                 | 解法                                                                                                      |
| ----------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------- |
| 提示无效令牌 / 401                        | 密钥复制不完整，或 Key 已被吊销 | 重新完整复制（注意 `sk-praxis-` 前缀）；仍失败就到[控制台](https://console.deepraxis.ai/keys)重建一个                            |
| 首次发消息报「需要通过本地 API Gateway 桥接，网关已禁用」 | 本地网关默认关闭           | 按弹窗提示点「启用」，再重发一次                                                                                        |
| 模型列表拉取失败或为空                         | API 地址路径不对         | 地址必须是 `https://api.deepraxis.ai/openai/v1`（以 `/v1` 结尾，弹窗的请求路径预览可自查）；先跑上面 curl 分辨是网络还是配置问题；拉取不成用「手动添加模型」 |
| 报「模型不存在」                            | 模型 ID 与目录不一致       | 到[控制台 → 模型](https://console.deepraxis.ai/models)复制确切 ID                                                 |
| 请求超时 / 无响应                          | 本地网络环境             | 换网络或代理后重试；若 curl 同样超时，则是网络问题，与配置无关                                                                      |

## 进阶 [#进阶]

* **查这段对话花了多少钱**：[控制台 → 用量与费用](https://console.deepraxis.ai/usage)，按次计费、无闲置费
* **换模型**：模型列表里随时勾选添加其他模型，对话页随时切换。`deepseek-flash` 是滚动入口，始终指向最新一代 Flash（随官方更新换代）；需要固定版本时改用 `deepseek-v4-flash`（版本快照）
* **用 Anthropic 协议接入**：在第 2 步弹窗的端点设置里改填 **Anthropic** 根地址 `https://api.deepraxis.ai/anthropic`（不加 `/v1`，客户端自动拼 `/v1/messages`，弹窗预览可核对），其余步骤相同

## 相关食谱 [#相关食谱]

* [Chatbox](/docs/cookbook/chat-clients/chatbox) · [LobeHub](/docs/cookbook/chat-clients/lobehub) · [Open WebUI](/docs/cookbook/chat-clients/open-webui)
* 从其他服务迁移过来？看[迁移指南](/docs/cookbook/migration)