# Vertex AI

## 教程概述

### 1. 获取 API Key

* 获取 Gemini 的 API Key 前，你需要有一个 Google Cloud 项目（如果你已有，此过程可跳过）
* 进入 [Google Cloud](https://console.cloud.google.com/projectcreate) 创建项目，填写项目名称并点击创建项目

<figure><img src="/files/cwuttVCBSQHNRCda9dXT" 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/9SFBPkFwFDox9AMRkM6X" alt=""><figcaption></figcaption></figure>

## 2. 设置 API 访问权限

* 打开 [服务账号](https://console.cloud.google.com/iam-admin/serviceaccounts) 权限界面，创建服务账号

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

* 在服务账号管理页面找到刚刚创建的服务账号，点击`密钥`并创建一个新的 JSON 格式密钥

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

* 创建成功后，密钥文件将会以 JSON 文件的格式自动保存到你的电脑上，请 **妥善保存**

## 3. 在Cherry Studio中配置Vertex AI

* 选择Vertex AI服务商
* 将JSON文件的对应字段填入

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

点击添加 [模型](https://console.cloud.google.com/vertex-ai/model-garden)，就可以愉快地开始使用了！


---

# Agent Instructions: 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:

```
GET https://docs.cherry-ai.com/pre-basic/providers/vertex-ai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.