Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página mostra o processo de configuração para acessar as APIs pré-treinadas da Vertex AI na infraestrutura isolada do Google Distributed Cloud (GDC), permitindo integrar recursos de IA ao seu aplicativo isolado. Você pode encontrar detalhes sobre os pré-requisitos e as etapas para ativar e desativar as APIs Vertex AI no console do GDC.
Esta página é destinada a desenvolvedores de aplicativos em grupos de operadores de aplicativos que são responsáveis por otimizar aplicativos isolados com recursos de IA. Para mais informações, consulte Públicos-alvo da documentação isolada do GDC.
A Vertex AI no Distributed Cloud inclui várias APIs que precisam ser ativadas no console do GDC para permitir que os usuários da sua organização interajam com modelos de ML e recursos de IA. Para saber mais sobre
essas APIs, consulte a seguinte documentação:
Antes de começar, verifique se você concluiu as etapas de pré-requisito a seguir:
Você precisa ter o papel de administrador da AI Platform (ai-platform-admin) para configurar o acesso às APIs da Vertex AI. Entre em contato com o administrador do IAM da organização ou do projeto para solicitar o papel, caso ainda não o tenha. Como alternativa, peça para o administrador ativar as APIs Vertex AI em seu nome. Para informações sobre esse papel, consulte Preparar permissões do IAM.
Configure o Sistema de Nomes de Domínio (DNS) do GDC. Se você ainda não tiver configurado o DNS, trabalhe com seu operador de infraestrutura (IO) para concluir esse pré-requisito.
Se você trouxer seu próprio modelo porque quer usar a previsão on-line ou executar notebooks de inteligência artificial (IA) e machine learning (ML) em um ambiente de GPU, alocar máquinas de GPU para os tipos de cluster corretos.
Ativar APIs pré-treinadas
É possível ativar as APIs e os modelos de serviço da Vertex AI usando o
console do GDC.
O alerta VAI-A0001 (Enabling State Time Limit Reached) é acionado se os
serviços demorarem muito para serem ativados. Nesse caso, sua OI precisa analisar o
runbook VAI-R0001 para mais detalhes.
Desativar APIs pré-treinadas
É possível desativar as APIs pré-treinadas usando o console do GDC.
No menu de navegação, clique em Vertex AI>APIs pré-treinadas.
Na página APIs pré-treinadas, clique em Desativar em um serviço específico para desativar essa API.
Na caixa de diálogo de confirmação, digite disable no campo de texto para confirmar
que você quer realizar essa ação. Depois, clique em Desativar. Uma mensagem de progresso vai aparecer.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eThis page outlines how to provision GPU resources on a container for AI/ML workloads and enable Vertex AI pre-trained APIs on Google Distributed Cloud (GDC) air-gapped.\u003c/p\u003e\n"],["\u003cp\u003eAdministrator access is generally required to configure GPU resources and manage Vertex AI pre-trained APIs, so you may need to request these actions if lacking the necessary permissions.\u003c/p\u003e\n"],["\u003cp\u003eVertex AI on GDC offers pre-trained APIs for Optical Character Recognition (OCR), Speech-to-Text, and Translation, along with services like Online Prediction and Vertex AI Workbench.\u003c/p\u003e\n"],["\u003cp\u003eProvisioning GPUs involves setting up DNS, creating a GPU-supporting cluster, and configuring containers to utilize GPU resources.\u003c/p\u003e\n"],["\u003cp\u003eThe GDC console is used to enable, deactivate, and monitor the status of the OCR, Speech-to-Text, and Vertex AI Translation pre-trained APIs.\u003c/p\u003e\n"]]],[],null,["# Enable Vertex AI APIs\n\nThis page guides you through the setup process for accessing Vertex AI pre-trained APIs within the Google Distributed Cloud (GDC) air-gapped infrastructure, allowing you to integrate AI features into your air-gapped application. You can find details about the prerequisites and the steps for enabling and deactivating the Vertex AI APIs through the GDC console console.\n\nThis page is for application developers within application operator groups who are responsible for optimizing air-gapped applications with AI features. For more information, see [Audiences for GDC air-gapped documentation](/distributed-cloud/hosted/docs/latest/gdch/resources/audiences).\n\nVertex AI on Distributed Cloud includes various APIs that\nyou must enable from the GDC console to let users from your\norganization interact with ML models and AI capabilities. To learn more about\nthese APIs, see the following documentation:\n\n- **Generative AI** : [Learn about Generative AI capabilities and available models](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/genai/genai-overview).\n- **Online Prediction** : [Learn about online predictions](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-online-predictions).\n- **Optical Character Recognition (OCR)** : [Learn about character recognition features](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-ocr).\n- **Speech-to-Text** : [Learn about speech recognition features](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-stt).\n- **Vertex AI Translation** : [Learn about translation features](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-translation).\n- **Vertex AI Workbench** : [Learn about Vertex AI Workbench](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-workbench-intro).\n\nBefore you begin\n----------------\n\nBefore you begin, check that you've done the following prerequisite steps:\n\n1. You must have the AI Platform Admin (`ai-platform-admin`) role to set up access to the Vertex AI APIs. You can contact your Organization IAM Admin or Project IAM 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](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-ao-permissions).\n2. 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.\n3. [Set up a project to use Vertex AI](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-set-up-project).\n4. If you bring your own model because you want to use\n [Online Prediction](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-online-predictions)\n or run artificial intelligence (AI) and machine learning (ML) notebooks in a\n GPU environment, make sure to\n [allocate GPU machines](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/create-user-cluster#gpu)\n for the correct cluster types.\n\n | **Note:** Pre-trained APIs run on a shared service Kubernetes cluster managed by the infrastructure.\n\nEnable pre-trained APIs\n-----------------------\n\nYou can enable Vertex AI service APIs and models using the\nGDC console.\n\nAfter [meeting the prerequisites](#before-you-enable-apis), follow these steps\nto enable APIs:\n\n1. [Sign in to the GDC console](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/iam/sign-in). If you can't sign in, see [Connect to an identity provider](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/iam/connect-identity).\n2. In the navigation menu, click **Vertex AI** \\\u003e **Pre-trained APIs**.\n3. On the **Pre-trained APIs** page, click **Enable** on a specific service to\n enable that API.\n\n | **Note:** The GDC console doesn't display the buttons to enable the pre-trained APIs if you don't have the correct permissions.\n4. In the confirmation dialog, click **Enable**. A progress message displays.\n\nThe enablement duration varies. It might take between 15 and 45 minutes to\nfinish, depending on the state of the cluster.\n\nIf you want to view the status of the pre-trained APIs,\n[view the service status and endpoints](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-api-status).\n\nThe VAI-A0001 alert (`Enabling State Time Limit Reached`) triggers if the\nservices take a long time to be enabled. In this case, your IO must review the\nVAI-R0001 runbook for details.\n| **Note:** You can't enable an API while you wait for another API to finish deactivating.\n\nDeactivate pre-trained APIs\n---------------------------\n\nYou can deactivate pre-trained APIs using the GDC console.\n\nAfter [meeting the prerequisites](#before-you-enable-apis), follow these steps\nto deactivate APIs:\n\n1. [Sign in to the GDC console](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/iam/sign-in).\n2. In the navigation menu, click **Vertex AI** \\\u003e **Pre-trained APIs**.\n3. On the **Pre-trained APIs** page, click **Disable** on a specific service to\n deactivate that API.\n\n | **Note:** The GDC console doesn't display the buttons to deactivate the pre-trained APIs if you don't have the correct permissions.\n4. In the confirmation dialog, enter *disable* in the text field to confirm\n that you want to take that action. Then, click **Disable**. A progress\n message displays.\n\nIf you want to view the status of the pre-trained APIs,\n[view the service status and endpoints](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-api-status).\n| **Note:** You can't deactivate an API while you wait for another API to finish enabling."]]