> 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/vertex-ai.md).

# Vertex AI

## 教程概覽

### 1. 攞 API Key

* 喺攞 Gemini 嘅 API Key 之前，你需要有一個 Google Cloud 專案（如果你已經有，呢個步驟可以跳過）
* 入去 [Google Cloud](https://console.cloud.google.com/projectcreate) 建立項目，填寫項目名稱，然後點擊建立項目

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

* 入去[Vertex AI 控制台](https://console.cloud.google.com/vertex-ai)
* 喺建立好嘅專案入面啟用 [Vertex AI API](https://console.cloud.google.com/apis/library/aiplatform.googleapis.com?inv=1\&invt=Ab0iBA)

<figure><img src="/files/78e14f83eb4d071a6be1ca96c2b832f5e0cae46e" alt=""><figcaption></figcaption></figure>

## 2. 設定 API 存取權限

* 打開 [服務帳號](https://console.cloud.google.com/iam-admin/serviceaccounts) 喺權限頁面，建立服務帳號

<figure><img src="/files/5417de375dfe78ed77055c6c0e5489de3d00708c" alt=""><figcaption></figcaption></figure>

* 喺服務帳號管理頁面搵返頭先建立嘅服務帳號，撳`密鑰`再建立一個新的 JSON 格式密鑰

<figure><img src="/files/26c8161f60567fd3612b7687cacfe20ceabfce0c" alt=""><figcaption></figcaption></figure>

* 建立成功之後，密鑰檔案會以 JSON 檔案格式自動儲存到你部電腦上，請 **妥善保存**

## 3. 喺 Cherry Studio 入面配置 Vertex AI

* 揀選 Vertex AI 服務商
* 將 JSON 檔案對應欄位填入

<figure><img src="/files/9c73a1657249fa1fb67f8559b52a54f9ed47d14c" alt=""><figcaption></figcaption></figure>

撳添加 [模型](https://console.cloud.google.com/vertex-ai/model-garden)，就可以愉快咁開始使用喇！

***

### 💡 獲取幫助同提交反饋

如果您喺配置或使用過程中遇到任何疑問、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/vertex-ai.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.