> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/pre-basic/providers/providers.md).

# 模型服务设置

本页介绍 `设置 → 模型服务` 里单个服务商配置页的各项功能。配置某一家服务商的完整流程，见 服务商配置。

{% hint style="info" %}

* 内置服务商通常只需填对应的 **API 密钥**。
* 不同服务商对密钥的叫法不同：密钥、Key、API Key、令牌，指的都是同一个东西。
  {% endhint %}

### API 密钥

填入服务商的 API 密钥即可。Cherry Studio 支持 **一个服务商配置多个密钥、轮询使用**（按列表从前到后循环）。有两种管理方式：

* **快速添加**：多个密钥用 **英文逗号** 隔开直接填入，如 `sk-xxx1,sk-xxx2,sk-xxx3`。
* **API 密钥管理**：点 API 密钥输入框右侧的 **钥匙图标按钮**（悬停显示「API 密钥管理」）即可进入——每个密钥是一个独立条目，可分别 **编辑标签**、**启用 / 禁用**、**复制**、**删除**。

{% hint style="warning" %}
用逗号分隔多个密钥时，必须使用 **英文** 逗号。
{% endhint %}

### API 地址

内置服务商一般无需填 API 地址（用默认即可）。如需修改，请按服务商官方文档填写。

> 若服务商给的是 `https://xxx.com/v1/chat/completions` 这种完整地址，通常只填 **根地址** `https://xxx.com` 即可，Cherry Studio 会自动补上 `/v1/chat/completions`。

{% hint style="info" %}
如果服务商的请求路径不是常规的 `/v1/chat/completions`，可在 API 地址栏填 **完整地址并以 `#` 结尾**——以 `#` 结尾时不再自动拼接版本路径，只用你填的地址。
{% endhint %}

### 添加模型

点服务商配置页的「**获取模型列表**」按钮，会拉取该服务商支持的模型；在弹出的「模型管理」列表里点模型右侧的 `+` 把它加入你的模型列表。**只有加入列表的模型** 才会出现在各处的模型选择器里。

模型名称下方会显示服务商返回的 **实际 API 模型 ID**。日期版、供应商前缀版等名称相近的模型不会再被合并；添加或选择模型前，先核对这行 ID，避免选到同名的另一版本。

### 连通性检查

点「**检测**」按钮、选一个模型即可测试是否配置成功（配置多个密钥时，还可选择用哪个密钥检测）。若检测失败，请检查模型列表里是否有填错的或不受支持的模型。

### API 设置（高级）

部分服务商可在「**API 设置**」里开启特定能力，如：支持数组格式的 message content、Developer Message、`enable_thinking`（控制 Qwen3 等模型的思考）、`service_tier`（仅 OpenAI）等。一般无需改动。

{% hint style="danger" %}
配置好后，务必打开服务商右上角的 **启用开关**，否则该服务商仍未启用，其模型不会出现在模型选择列表里。
{% endhint %}

***

### 获取帮助与提交反馈

如果您在配置或使用过程中遇到任何疑问、Bug 或有功能改进建议，请参考 [反馈与建议](/question-contact/suggestions.md) 中提供的官方渠道。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/pre-basic/providers/providers.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.