이 페이지는 개발자가 Vertex AI Translation을 사용하기 위해 Google Distributed Cloud (GDC) 오프라인 프로젝트를 설정하는 데 도움이 됩니다. 이 프로세스에는 프로젝트 생성, Vertex AI Translation API 사용 설정, 클라이언트 라이브러리 설치, 환경 변수 정의, 사용자 인증 정보 인증이 포함됩니다. Vertex AI를 처음 사용하는 경우 번역 기능에 대해 자세히 알아보세요.
다음과 같이 GDC 콘솔과 gdcloud CLI를 사용하여 번역 프로젝트를 설정합니다.
GDC 콘솔: Vertex AI Translation API를 사용 설정하고 서비스 상태와 엔드포인트를 확인합니다.
gdcloud CLI: Vertex AI Translation API와 상호작용하도록 서비스 계정을 구성하고, 클라이언트 라이브러리를 설치하고, API 요청을 인증합니다.
프로젝트 만들기
분산 클라우드 리소스 계층 구조 내에서 번역 프로젝트를 만들면 공동작업자, 사용 설정된 API, 모니터링 도구, 결제 정보, 인증 사용자 인증 정보, 액세스 제어를 포함한 Vertex AI Translation 리소스가 정리됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eThis page guides developers through setting up a Google Distributed Cloud (GDC) air-gapped project for using Vertex AI Translation, including creating a project and configuring access.\u003c/p\u003e\n"],["\u003cp\u003eUtilize the GDC console to enable the Vertex AI Translation API and the \u003ccode\u003egdcloud\u003c/code\u003e CLI to configure service accounts and manage API interactions.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers must obtain the AI Translation Developer role to access translation services and generate API tokens for authentication.\u003c/p\u003e\n"],["\u003cp\u003eInstall the Python client library, ensuring the version matches the one provided by your organization's GDC URL, to streamline interactions with the Vertex AI Translation API.\u003c/p\u003e\n"],["\u003cp\u003eSet environment variables in your Python script to manage service account keys and authenticate API requests by creating and running a JupyterLab notebook.\u003c/p\u003e\n"]]],[],null,["# Set up a translation project\n\nThis page helps developers set up a Google Distributed Cloud (GDC) air-gapped project\nto use Vertex AI Translation. This process includes creating a project,\nenabling the Vertex AI Translation API, installing\nclient libraries, defining environment variables, and authenticating your\ncredentials. If you are new to Vertex AI,\n[learn more about translation features](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-translation).\n\nYou set up a translation project using the GDC console and\ngdcloud CLI as follows:\n\n- **GDC console**: Enable the Vertex AI Translation API and view the service status and endpoint.\n- **The gdcloud CLI**: Configure service accounts to interact with the Vertex AI Translation API, install client libraries, and authenticate API requests.\n\nCreate a project\n----------------\n\nCreating a translation project within your Distributed Cloud [resource hierarchy](/distributed-cloud/hosted/docs/latest/gdch/overview#resource_hierarchy)\norganizes your Vertex AI Translation resources, which include collaborators,\nenabled APIs, monitoring tools, billing information, authentication credentials,\nand access controls.\n\nTo create your project, see [Set up a project for Vertex AI](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-set-up-project).\nYou need your project ID when making API calls.\n| **Tip:** Improve security, resource management, and cost tracking by isolating your experimental, testing, and production workloads in separate Distributed Cloud projects.\n\nRequest developer permissions\n-----------------------------\n\nYou must have the AI Translation Developer role in your project to\naccess translation services and generate an API token for request authentication\nand authorization.\n\nAsk your Project IAM Admin to grant the AI Translation Developer\n(`ai-translation-developer`) role to your user or service account\nwithin your project namespace. For information about this role, see\n[Prepare IAM permissions](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-ao-permissions).\n\nEnable the Vertex AI Translation API\n------------------------------------\n\nYou must [enable the Vertex AI Translation pre-trained API](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-enable-pre-trained-apis)\nfor your project. If enabled, you can [view the service status and endpoint for the Vertex AI Translation pre-trained API](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-api-status).\n\nInstall client libraries\n------------------------\n\nClient libraries are available for the Python programming language. We recommend\nusing these client libraries to make calls to the Vertex AI Translation API\nbecause they make it easier to access APIs.\n\n[Install the Vertex AI Translation client library](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-install-libraries)\nand follow these steps to ensure you have the correct version:\n\n1. Check if the Vertex AI Translation client library is installed and obtain\n the version number:\n\n pip freeze | grep translation\n\n If the client library is already installed, you obtain an output similar\n to the following example: \n\n google-cloud-translation==3.8.0\n\n The version number you obtain must match the client library at the\n following endpoint: \n\n https://\u003cvar translate=\"no\"\u003eGDC_URL\u003c/var\u003e/.well-known/static/client-libraries\n\n Replace \u003cvar translate=\"no\"\u003eGDC_URL\u003c/var\u003e with the\n URL of your organization in GDC.\n2. If the version numbers don't match, uninstall the client library:\n\n pip uninstall google-cloud-translation\n\n3. If you uninstalled the Vertex AI Translation client library, you must\n [reinstall it](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-install-libraries)\n by specifying the filename corresponding to your operating system.\n\nSet your environment variables\n------------------------------\n\nAfter installing the Vertex AI Translation client library, you can interact\nwith the API from a Python script.\n\nIf you [set up a service account](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-set-up-project#set-up-service)\nin your project to make authorized API calls programmatically, you can define\nenvironment variables in the Python script to access values such as the service\naccount keys when running.\n\nFollow these steps to set required environment variables on a Python script:\n\n1. [Create a JupyterLab notebook](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-workbench#create-notebook)\n to interact with the Vertex AI Translation pre-trained API.\n\n2. Create a Python script on the JupyterLab notebook.\n\n3. Add the following code to the Python script:\n\n import os\n\n os.environ[\"GOOGLE_APPLICATION_CREDENTIALS\"] = \"\u003cvar translate=\"no\"\u003eAPPLICATION_DEFAULT_CREDENTIALS_FILENAME\u003c/var\u003e\"\n\n Replace \u003cvar translate=\"no\"\u003eAPPLICATION_DEFAULT_CREDENTIALS_FILENAME\u003c/var\u003e with\n the name of the JSON file that contains [the service account keys you created](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-set-up-project#set-up-service)\n in the project, such as `my-service-key.json`.\n4. Save the Python script with a name, such as `translation.py`.\n\n5. Run the Python script to set the environment variables:\n\n python \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eSCRIPT_NAME\u003c/span\u003e\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003eSCRIPT_NAME\u003c/var\u003e with the name you gave to your\n Python script, such as `translation.py`.\n\n| **Note:** Keep the script open when using the environment variables from Python or getting an authentication token.\n\nSet up authentication\n---------------------\n\nBefore you can start using the Vertex AI Translation API, you must authenticate\nyour client credentials and request account access to your project resources.\nFor more information, see [Authenticate API requests](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-api-auth)."]]