> ## Documentation Index
> Fetch the complete documentation index at: https://crypto-serve.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cherry Studio 接入

> 在 Cherry Studio 手动配置 CryptoServeAI，完成模型选择和首次对话。

# Cherry Studio 接入

本页使用 OpenAI 兼容的文本对话配置。请先安装 [Cherry Studio 官方版本](https://github.com/CherryHQ/cherry-studio/releases)，准备好 [API 密钥](https://crypto-serve.mintlify.site/zhang-hao-shi-yong-jiao-cheng-mao-li-she-qu/cryptoserveai/api-keys.md)、可用额度及支持聊天补全接口的模型 ID。

## 1. 添加提供商

打开设置中的模型服务或提供商页面，新增自定义提供商。选择 OpenAI 兼容类型，名称填写 CryptoServeAI。不同版本的按钮名称可能略有不同。

## 2. 填写地址与密钥

| 项目 | 内容 |
| - | - |
| 提供商名称 | CryptoServeAI |
| API 地址 | `https://api.cryptoserve.io` |
| API Key | 为本客户端创建的完整密钥 |

按照 Cherry Studio 的标准地址拼接规则，根地址会补成 `https://api.cryptoserve.io/v1/chat/completions`。这里不要粘贴完整聊天端点，也不需要在末尾添加 `#`。

代码或 SDK 中常见的 Base URL 是 `https://api.cryptoserve.io/v1`，与这里填写的根地址作用不同。若界面展示请求地址，请检查没有重复的 `/v1/v1`。

## 3. 添加模型并启用

点击获取模型列表或管理模型，在返回列表中将所需模型加入提供商。如果需要手动添加，完整复制平台模型 ID，不要只填昵称。

确认提供商已启用，再到聊天界面选择它下面的模型。能获取模型列表不代表每个模型都支持文本对话，请核对模型的接口类型。

## 4. 完成测试

新建对话，发送一句简短问题。收到回复后，到 CryptoServeAI 查看相应调用记录与消耗。连接检测失败时，也要核对检测所用的模型是否可用。

## 常见情况

| 情况 | 处理方式 |
| - | - |
| 聊天中找不到模型 | 检查是否已添加模型，并开启提供商 |
| 401 | 检查密钥是否完整、有效 |
| 404 或路径错误 | 核对根地址、提供商类型和最终请求路径 |
| 列表正常但对话失败 | 检查模型接口、权限、余额及具体错误信息 |

本页按官方配置规则编写，不代表所有客户端版本和所有模型都已在 CryptoServeAI 实测。一键导入不是本教程的必要步骤。

参考：[Cherry Studio 提供商设置](https://github.com/CherryHQ/cherry-studio-docs/blob/main/pre-basic/settings/providers.md)。更多排查见[常见问题](https://crypto-serve.mintlify.site/zhang-hao-shi-yong-jiao-cheng-mao-li-she-qu/cryptoserveai/faq.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.