> For the complete documentation index, see [llms.txt](https://docs.mindmac.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mindmac.app/how-to.../add-api-key/create-google-cloud-vertex-ai-api-key.md).

# Create Google Cloud Vertex AI API Key

### Step 1: Create new project

Go to <https://console.cloud.google.com/projectcreate>, enter project name and click **Create.**

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

### Step 2: Create new service account

Go to [https://console.cloud.google.com/iam-admin/serviceaccounts](https://console.cloud.google.com/iam-admin/serviceaccounts?authuser=1), select the project just created in [#step-1-create-new-project](#step-1-create-new-project "mention").

Click **Create Service Account**.

<figure><img src="/files/2klFbRx7q16cHXSy2LnB" alt=""><figcaption></figcaption></figure>

Enter name, description for service account and click **Create and Continue**.

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

Click **Select a role** and search for **Vertex AI Service Agent**, then select it.

<figure><img src="/files/3nZblXRZ5bdO6BOReKBP" alt=""><figcaption></figcaption></figure>

Click **Continue**.

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

Click **Done**.

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

### Step 3: Generate new key

Click on the service account just created, then select **Keys** tab.

<figure><img src="/files/2o2mwmBhDpWWmq88Pmql" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/4sF98vwQGzUlzT8YmIc4" alt=""><figcaption></figcaption></figure>

Click **Add Key** and select **Create new key**.

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

Select **JSON** and click **Create**.

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

A JSON file will be downloaded into your machine. Keep that file secret. Open that file and copy whole file content.

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

Key file content looks like below:

```
{
  "type": "service_account",
  "project_id": "mindmac-300128",
  "private_key_id": "12efb3bcc7u7dbf111842f27415d37454c6d6fa012",
  "private_key": "-----BEGIN PRIVATE KEY-----\nMIIE...8XI3A=\n-----END PRIVATE KEY-----\n",
  "client_email": "mindmac-service-account@mindmac-300128.iam.gserviceaccount.com",
  "client_id": "208453549200948148846",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/mindmac-service-account%40mindmac-300128.iam.gserviceaccount.com",
  "universe_domain": "googleapis.com"
}
```

### Step 4: Enable Vertex AI API

Go to <https://console.cloud.google.com/marketplace/product/google/aiplatform.googleapis.com>, select the project just created and click **Enable** to activate Vertex AI API.

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

### Step 5: Grab information to construct API URL

Go to <https://console.cloud.google.com/vertex-ai>, select project just created and take note region name.

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

Go to <https://console.cloud.google.com/welcome>, select project just created and copy the project ID.

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

Vertex AI API URL has format:&#x20;

```
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models
```

* LOCATION is the region name above, for example **us-central1**
* PROJECT\_ID is the ID of the project above

In this case it should be:

```
https://us-central1-aiplatform.googleapis.com/v1/projects/mindmac-300128/locations/us-central1/publishers/google/models
```

***

### Add Google Vertex AI key

Go to **MindMac** -> **Settings...** -> **Account** or press <mark style="color:purple;">**⌘ + ,**</mark> to open Account Setting.

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

Select **Vertex AI** provider, enter name and your custom URL from [#step-5-grab-information-to-construct-api-url](#step-5-grab-information-to-construct-api-url "mention"), paste Service Account key content from [#step-2-create-new-service-account](#step-2-create-new-service-account "mention") and click **Save** to finish.