> 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/settings/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/settings/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.