> 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/docs/zhong-wen-fan-ti/pre-basic/providers/doubao.md).

# 火山引擎

* 登入 [火山引擎](https://console.volcengine.com/)
* 直接撳 [呢度直達](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D)

<figure><img src="/files/44704bd6a58b0aca136bfe39ea86e64cb3bade1e" alt=""><figcaption></figcaption></figure>

### 取得 API Key

* 撳側欄下方嘅 [API Key 管理](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey)
* 建立 API Key

<figure><img src="/files/e7b9c6ff314b674223f04a34e7389903454427ca" alt=""><figcaption></figcaption></figure>

* 成功建立後，撳已建立嘅 API Key 後面個細眼仔打開並複製

<figure><img src="/files/dcf466e0fd787f98fcb9e81712dd77221cee1ed0" alt=""><figcaption></figcaption></figure>

* 將複製嘅 API Key 填入 CherryStudio 之後，打開服務商開關。

<figure><img src="/files/5e85f20f8fc274ab3ac34922092b9129d557a475" alt=""><figcaption></figcaption></figure>

### 開通同添加模型

* 喺方舟控制台側欄最底下嘅 [開通管理](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D\&OpenTokenDrawer=false) 開通需要用嘅模型，呢度可以按需要開通豆包系列同 DeepSeek 等模型。

<figure><img src="/files/b21544dfe08167017586f3b57e57e0bd7db92892" alt=""><figcaption></figcaption></figure>

* 喺 [模型列表文件](https://www.volcengine.com/docs/82379/1330310#%E6%96%87%E6%9C%AC%E7%94%9F%E6%88%90) 裏面，搵到所需模型對應嘅 模型 ID。

<figure><img src="/files/0a64cfde71a49ee96057f71580351b4f6f4f7b93" alt="火山引擎模型ID列表示例"><figcaption></figcaption></figure>

* 打開 Cherry Studio 嘅 [模型服務](/docs/zhong-wen-fan-ti/pre-basic/providers/providers.md) 設定，搵到火山引擎
* 撳添加，將之前攞到嘅 模型 ID 複製去 模型 ID 文字對話框就得

<figure><img src="/files/5d37f72d29da4934e75216e3773f7bbe1e466f8e" alt=""><figcaption></figcaption></figure>

* 跟住呢個流程逐個添加模型

### API 地址

API 地址有兩種寫法

* 第一種係客戶端預設嘅：`https://ark.cn-beijing.volces.com/api/v3/`
* 第二種寫法係：`https://ark.cn-beijing.volces.com/api/v3/chat/completions#`

{% hint style="info" %}
兩種寫法冇咩分別，保持預設就得，唔使修改。

關於 `/` 同 `#` 尾部個分別可以參考文件入面服務商設定嘅 API 地址部分，[撳前往](/docs/zhong-wen-fan-ti/pre-basic/providers/providers.md#api-di-zhi)
{% endhint %}

<figure><img src="/files/02ca452f170070aced30ad96860e2d50edc5283e" alt=""><figcaption><p>官方文件 cURL 示例</p></figcaption></figure>

***

### 攞幫助同提交意見

如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改善建議，請參考 [反饋與建議](/docs/zhong-wen-fan-ti/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/docs/zhong-wen-fan-ti/pre-basic/providers/doubao.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.