이 페이지에서는 Google Cloud 콘솔, 프로그래밍 언어 SDK 또는 REST API를 사용하여 신속하게 Vertex AI Gemini API로 요청 전송을 시작하는 방법을 보여줍니다.
Google Cloud 처음 사용
Google Cloud에서 설정
Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다. 설정 프로세스는 간단한 3단계입니다.
다음 버튼을 사용하여 계정을 만듭니다. 완료되면 이 페이지로 돌아와 이 초보자 튜토리얼을 완료합니다. 이 사이트에서 제공되는 모든 기능을 사용하려면 계정을 사용하여 로그인합니다.
계정 만들기Google Cloud에서 설정하는 방법에 대한 자세한 내용은 Google Cloud에서 설정을 참조하세요.
Vertex AI Gemini API에 요청 보내기
Vertex AI Gemini API에 요청을 보내는 방법을 보려면 다음 탭 중 하나를 선택합니다.
Python
- 다음을 수행하여 Google Cloud 프로젝트를 선택합니다.
Google Cloud 콘솔에서 대시보드 페이지로 이동합니다.
페이지 상단의 프로젝트 선택 목록을 클릭합니다. 리소스 선택 창이 나타나면 프로젝트를 선택합니다.
- 프로젝트 정보 섹션에 표시된 프로젝트 ID를 기록합니다. 이후 단계에서 프로젝트 ID가 필요합니다.
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Cloud Shell에서 다음 명령어를 실행하여 Python용 Vertex AI SDK를 설치하거나 업데이트합니다.
pip3 install "google-cloud-aiplatform>=1.38"
프롬프트 요청을 보냅니다. PROJECT_ID를 Google Cloud 프로젝트의 ID로 바꿉니다.
Python용 Vertex AI SDK 설치, 업데이트, 사용에 대한 자세한 내용은 Python용 Vertex AI SDK 설치 및 Python용 Vertex AI SDK API 참고 문서를 확인하세요.
Node.js
- 다음을 수행하여 Google Cloud 프로젝트를 선택합니다.
Google Cloud 콘솔에서 대시보드 페이지로 이동합니다.
페이지 상단의 프로젝트 선택 목록을 클릭합니다. 리소스 선택 창이 나타나면 프로젝트를 선택합니다.
- 프로젝트 정보 섹션에 표시된 프로젝트 ID를 기록합니다. 이후 단계에서 프로젝트 ID가 필요합니다.
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Cloud Shell에서 다음 명령어를 실행하여 Node.js용 Vertex AI SDK를 설치하거나 업데이트합니다.
npm install @google-cloud/vertexai
프롬프트 요청을 보냅니다. PROJECT_ID를 Google Cloud 프로젝트의 ID로 바꿉니다.
Vertex AI Node.js SDK 설치 및 사용에 대한 자세한 내용은 Node.js용 Vertex AI SDK 참고 문서를 확인하세요.
Java
다음을 수행하여 Google Cloud 프로젝트를 선택합니다.
Google Cloud 콘솔에서 대시보드 페이지로 이동합니다.
페이지 상단의 프로젝트 선택 목록을 클릭합니다. 리소스 선택 창이 나타나면 프로젝트를 선택합니다.
프로젝트 정보 섹션에 표시된 프로젝트 ID를 확인합니다. 이후 단계에서 프로젝트 ID가 필요합니다.
다음 명령어를 실행하여 인증합니다. PROJECT_ID를 Google Cloud 프로젝트 ID로 바꾸고 ACCOUNT를 Google Cloud 사용자 이름으로 바꿉니다.
gcloud config set project PROJECT_ID && gcloud auth login ACCOUNT
google-cloud-vertexai
를 종속 항목으로 추가합니다.<!--If you are using Maven with BOM, add the following in your pom.xml--> <dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>libraries-bom</artifactId> <version>26.32.0</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-vertexai</artifactId> </dependency> </dependencies> <!--If you are using Maven without BOM, add the following to your pom.xml--> <dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-vertexai</artifactId> <version>0.4.0</version> </dependency> <!--If you are using Gradle without BOM, add the following to your build.gradle--> implementation 'com.google.cloud:google-cloud-vertexai:0.4.0'
프롬프트 요청을 보냅니다.
projectID
를 Google Cloud 프로젝트 ID로 설정합니다.Vertex AI Java 개발 키트(JDK) 설치 및 사용에 대한 자세한 내용은 Vertex AI JDK 참고 문서를 확인하세요.
Go
- 다음을 수행하여 Google Cloud 프로젝트를 선택합니다.
Google Cloud 콘솔에서 대시보드 페이지로 이동합니다.
페이지 상단의 프로젝트 선택 목록을 클릭합니다. 리소스 선택 창이 나타나면 프로젝트를 선택합니다.
- 프로젝트 정보 섹션에 표시된 프로젝트 ID를 기록합니다. 이후 단계에서 프로젝트 ID가 필요합니다.
- Go 개발을 위해 환경을 준비합니다.
사용 가능한 Vertex AI API Go 패키지를 검토하여 프로젝트 요구에 가장 적합한 패키지를 확인합니다.
패키지 cloud.google.com/go/vertexai (권장)
vertexai
는 일반적인 기능에 대한 액세스를 제공하는 인간이 작성한 패키지입니다.이 패키지는 Vertex AI API를 사용하여 빌드하는 대부분의 개발자에게 시작점으로 권장됩니다. 이 패키지에 아직 포함되지 않은 기능을 이용하려면 자동 생성된
aiplatform
을 사용하세요.패키지 cloud.google.com/go/aiplatform
aiplatform
은 자동 생성된 패키지입니다.이 패키지는 인간이 작성한
vertexai
패키지에서 아직 제공하지 않는 Vertex AI API 기능에 액세스해야 하는 프로젝트를 대상으로 합니다.
다음 명령어중 하나를 실행하여 프로젝트 요구에 따라 원하는 Go 패키지를 설치합니다.
# Human authored package. Recommended for most developers. go get cloud.google.com/go/vertexai
# Auto-generated package. go get cloud.google.com/go/aiplatform프롬프트 요청을 보냅니다. PROJECT_ID를 Google Cloud 프로젝트의 ID로 바꿉니다.
Go용 Vertex AI SDK 설치 및 사용에 대한 자세한 내용은 Go용 Vertex AI SDK 참고 문서를 확인하세요.
C#
이 샘플을 사용해 보기 전에 Vertex AI 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Vertex AI C# API 참고 문서를 참조하세요.
Vertex AI에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
REST
다음을 수행하여 Google Cloud 프로젝트를 선택합니다.
Google Cloud 콘솔에서 대시보드 페이지로 이동합니다.
페이지 상단의 프로젝트 선택 목록을 클릭합니다. 리소스 선택 창이 나타나면 프로젝트를 선택합니다.
프로젝트 정보 섹션에 표시된 프로젝트 ID를 확인합니다. 이후 단계에서 프로젝트 ID가 필요합니다.
In the Google Cloud console, activate Cloud Shell.
다음을 입력하여 환경 변수를 구성합니다. PROJECT_ID를 Google Cloud 프로젝트의 ID로 바꿉니다.
MODEL_ID="gemini-1.0-pro-vision" PROJECT_ID="PROJECT_ID"
엔드포인트를 프로비저닝합니다.
gcloud beta services identity create --service=aiplatform.googleapis.com --project=PROJECT_ID
다음 curl 명령어를 입력하여 프롬프트 요청을 보냅니다.
curl \ -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json" \ https://us-central1-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/us-central1/publishers/google/models/${MODEL_ID}:streamGenerateContent -d \ $'{ "contents": { "role": "user", "parts": [ { "fileData": { "mimeType": "image/jpeg", "fileUri": "gs://generativeai-downloads/images/scones.jpg" } }, { "text": "Describe this picture." } ] } }'
Cloud Shell을 승인하라는 메시지가 표시되면 승인을 클릭합니다.
모델이 응답을 반환합니다. 응답은 여러 섹션으로 생성되고, 안전을 위해 각 섹션이 개별적으로 평가됩니다.
콘솔
Vertex AI Studio를 사용하여 프롬프트를 빠르게 설계하고 반복할 수 있습니다. 프롬프트가 준비되면 지원되는 프로그래밍 언어로 프롬프트 코드를 가져올 수 있습니다.
- 다음을 수행하여 Google Cloud 프로젝트를 선택합니다.
Google Cloud 콘솔에서 대시보드 페이지로 이동합니다.
페이지 상단의 프로젝트 선택 목록을 클릭합니다. 리소스 선택 창이 나타나면 프로젝트를 선택합니다.
Google Cloud 콘솔에서 Vertex AI Studio 페이지로 이동합니다.
멀티모달을 클릭합니다.
샘플 프롬프트에서 이미지에서 텍스트 추출이라는 프롬프트를 찾고 열기를 클릭합니다.
프롬프트 페이지가 열리고 프롬프트 필드에 프롬프트가 채워집니다.
제출을 클릭하여 프롬프트를 제출합니다.
모델이 응답을 반환합니다.
코드 가져오기를 클릭하여 이 프롬프트 요청에 해당하는 코드를 확인합니다.
다음 단계
- Vertex AI Gemini API 참조 확인하기
- Vertex AI Gemini API Python SDK 참조 확인하기
- 멀티모달 모델 자세히 알아보기