Cherry Studio
把 Praxis 接入 Cherry Studio：一个 Key，聊所有模型。
把 Praxis 接入 Cherry Studio，用一个 Key 聊所有模型——全程不写代码。
每一步都标了期望结果：照做即可，也可以把本页直接交给能操作电脑的 AI 助手，让它替你完成配置与验证。
你将完成
- 在 Cherry Studio 里直接使用 Praxis 的模型对话
- 完成标志：向
deepseek-flash发送「你好」并收到回复 - 预计耗时：5 分钟（不含下载安装）
- 支持协议：OpenAI 兼容（本页路线）/ Anthropic 兼容（见进阶）
前提
开始前逐项确认：
- 一个 Praxis API Key（
sk-praxis-开头）。没有就到 控制台 → API Keys 创建：点「创建 Key」，弹窗中名称必填，有效期默认 90 天（可改永久），点创建后立即复制保存；之后也随时可在 Key 列表行点「复制」重新获取完整 Key。新账号自带 $1 免费额度，跑完本页绰绰有余。完整流程见快速开始。 - Cherry Studio 已安装。从官网下载（自动匹配系统），或到 GitHub Releases 手选：Windows 选
-setup.exe（安装版）或-portable.exe（免安装）；macOS 选.dmg（Intel 芯片选 x64，Apple 芯片选 arm64）；Linux 选.AppImage（下载后chmod +x加执行权限再运行）。 - 首次启动：先选语言（默认 English，可切中文），欢迎页点「稍后设置」跳过登录即可使用。
- 本页以 v2.1.4 界面为准，菜单位置可能随版本微调。
配置
第 1 步：打开模型服务设置
主界面左下角的齿轮图标「设置」，再点左侧菜单「模型服务」。
期望：右侧出现提供商列表（OpenAI、硅基流动、智谱开放平台……）。
第 2 步：添加服务商，一次填齐名称、密钥、地址
点提供商列表底部的「添加服务商」按钮，弹窗「添加自定义提供商」里填三处：
| 字段 | 填什么 |
|---|---|
| 提供商名称（必填） | Praxis（显示名，可任取） |
| API 密钥 | sk-praxis- 开头的你的 Key |
| 端点设置 → OpenAI 根地址 | https://api.deepraxis.ai/openai/v1 |
地址必须以 /v1 结尾——弹窗会实时显示「请求路径」预览，看到 …/openai/v1/chat/completions 即为正确。填完点「添加」。
期望：提供商列表末尾出现 Praxis 条目，卡片上密钥显示为掩码。
第 3 步：添加模型
添加成功后，Cherry Studio 会自动拉取 Praxis 的模型目录并弹出「选择模型」对话框。在列表中勾选 deepseek-flash——平台示例模型：便宜、快、中英文都好——点「添加所选模型」，应用会自动检测并启用。
期望：模型出现在 Praxis 的模型列表中，启用开关为开。
拉取失败或列表为空时，点 Praxis 卡片上的「手动添加模型」，模型 ID 填 deepseek-flash，其余留空即可。
验证
回到对话页，点右上角的模型选择器，切到 Praxis 下的 deepseek-flash，发送「你好」。
期望：几秒内收到一段中文回复——收到回复即接入成功。
也可以在命令行完成等价验证。先设置变量（不然照抄 curl 会得到 401）：
export PRAXIS_API_KEY=sk-praxis-你的Key以下命令为 macOS / Linux / WSL（bash）写法。Windows PowerShell 用户：界面已收到回复即接入成功，可跳过；如需命令行验证，先执行 $env:PRAXIS_API_KEY="你的Key"，再把 curl 写成一行（去掉每行末尾的 \）。
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 拼写问题——对照下方常见问题。
最后看一眼 控制台 → 用量与费用：刚才的调用已经记在账上——每一次调用都有账、可追溯。
常见问题
| 症状 | 原因 | 解法 |
|---|---|---|
| 提示无效令牌 / 401 | 密钥复制不完整，或 Key 已被吊销 | 重新完整复制（注意 sk-praxis- 前缀）；仍失败就到控制台重建一个 |
| 首次发消息报「需要通过本地 API Gateway 桥接，网关已禁用」 | 本地网关默认关闭 | 按弹窗提示点「启用」，再重发一次 |
| 模型列表拉取失败或为空 | API 地址路径不对 | 地址必须是 https://api.deepraxis.ai/openai/v1（以 /v1 结尾，弹窗的请求路径预览可自查）；先跑上面 curl 分辨是网络还是配置问题；拉取不成用「手动添加模型」 |
| 报「模型不存在」 | 模型 ID 与目录不一致 | 到控制台 → 模型复制确切 ID |
| 请求超时 / 无响应 | 本地网络环境 | 换网络或代理后重试；若 curl 同样超时，则是网络问题，与配置无关 |
进阶
- 查这段对话花了多少钱：控制台 → 用量与费用，按次计费、无闲置费
- 换模型：模型列表里随时勾选添加其他模型，对话页随时切换。
deepseek-flash是滚动入口，始终指向最新一代 Flash（随官方更新换代）；需要固定版本时改用deepseek-v4-flash（版本快照） - 用 Anthropic 协议接入：在第 2 步弹窗的端点设置里改填 Anthropic 根地址
https://api.deepraxis.ai/anthropic（不加/v1，客户端自动拼/v1/messages，弹窗预览可核对），其余步骤相同
相关食谱
- Chatbox · LobeHub · Open WebUI
- 从其他服务迁移过来？看迁移指南