Enable Vertex AI APIs

Vertex AI in Google Distributed Cloud (GDC) air-gapped provides pre-trained APIs for integrating artificial intelligence (AI) and machine learning (ML) into your air-gapped applications. Enable or deactivate these APIs in the GDC console so that users in your organization can interact with AI models and capabilities.

In the GDC console, you can enable Generative AI, Online Prediction, Optical Character Recognition (OCR), Speech-to-Text, Vertex AI Translation, and Vertex AI Workbench. This document is for application developers in application operator groups who optimize air-gapped applications with AI features. For more information, see Audiences for GDC air-gapped documentation.

Before you begin

Before you begin, check that you've done the following prerequisite steps:

1. You must have the AI Platform Admin (ai-platform-admin) role to set up access to the Vertex AI APIs. You can contact your IAM Org Admin or IAM Project Admin to request the role if you don't already have it. Alternatively, you can ask your administrator to enable Vertex AI APIs on your behalf. For information about this role, see Prepare IAM permissions.
2. Set up the GDC domain name system (DNS). If you haven't set up the DNS, work with your Infrastructure Operator (IO) to complete this prerequisite.
3. Set up a project to use Vertex AI.

4. If you bring your own model because you want to use Online Prediction or run artificial intelligence (AI) and machine learning (ML) notebooks in a GPU environment, make sure to allocate GPU machines for the correct cluster types.

   Note: Pre-trained APIs run on a shared service Kubernetes cluster managed by the infrastructure.

Enable pre-trained APIs

You can enable Vertex AI service APIs and models using the GDC console.

After meeting the prerequisites, follow these steps to enable APIs:

1. Sign in to the GDC console. If you can't sign in, see Connect to an identity provider.
2. In the navigation menu, click Vertex AI > Pre-trained APIs.

3. On the Pre-trained APIs page, click Enable on a specific service to enable that API.

   Note: The GDC console doesn't display the buttons to enable the pre-trained APIs if you don't have the correct permissions.

4. In the confirmation dialog, click Enable. A progress message displays.

The enablement duration varies. It might take between 15 and 45 minutes to finish, depending on the state of the cluster.

If you want to view the status of the pre-trained APIs, view the service status and endpoints.

The VAI-A0001 alert for Enabling State Time Limit Reached triggers if the services take a long time to be enabled. In this case, your IO must review the VAI-R0001 runbook for details.

Note: You can't enable an API while you wait for another API to finish deactivating.

Deactivate pre-trained APIs

You can deactivate pre-trained APIs using the GDC console.

After meeting the prerequisites, follow these steps to deactivate APIs:

1. Sign in to the GDC console.
2. In the navigation menu, click Vertex AI > Pre-trained APIs.

3. On the Pre-trained APIs page, click Disable on a specific service to deactivate that API.

   Note: The GDC console doesn't display the buttons to deactivate the pre-trained APIs if you don't have the correct permissions.

4. In the confirmation dialog, enter disable in the text field to confirm that you want to take that action. Then, click Disable. A progress message displays.

If you want to view the status of the pre-trained APIs, view the service status and endpoints.

Note: You can't deactivate an API while you wait for another API to finish enabling.