Google Cloud API 키 가져오기

Vertex AI 기반 Gemini를 사용하려면 Google Cloud API 키를 사용하거나 애플리케이션 기본 사용자 인증 정보를 사용하여 인증해야 합니다. 테스트에는 API 키를, 프로덕션에는 애플리케이션 기본 사용자 인증 정보를 사용하는 것이 좋습니다. 이 페이지에서는 이미 Google Cloud 계정이 있는지 여부에 따라 Google Cloud API 키를 가져오는 방법을 보여줍니다.

Google Cloud 계정이 있는지 선택합니다.

Google Cloud API 키 만들기

이미 Google Cloud 계정이 있으면 다음 안내를 수행하여 표준 Google Cloud API 키를 가져옵니다. 또는 API 키를 사용하는 대신 애플리케이션 기본 사용자 인증 정보를 사용할 수 있습니다.

시작하기 전에

프로젝트 선택, 결제 사용 설정, Vertex AI API 사용 설정

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Enable the API

    8.

서비스 계정 API 키 생성 사용 설정

  1. IAM 및 관리자 > 조직 정책을 엽니다.
  2. 정책 목록에서 iam.managed.disableServiceAccountApiKeyCreation 정책을 필터링합니다.
  3. 작업 > 정책 수정을 클릭합니다.
  4. 정책 소스에서 상위 정책 재정의를 선택한 후 규칙 추가를 클릭합니다.
  5. 시행에서 사용 안함을 선택합니다.
  6. 완료를 클릭합니다.
  7. 정책 설정을 클릭합니다. 대화상자가 팝업되면 정책 설정을 다시 클릭합니다.

새 서비스 계정 만들기

  1. IAM 및 관리자 > 서비스 계정을 엽니다.
  2. 서비스 계정 만들기를 클릭합니다.
  3. 다음과 같이 서비스 계정을 구성합니다.
    • 서비스 계정 이름: vertex-ai-runner
    • 서비스 계정 ID: vertexairunner
  4. 만들고 계속하기를 클릭합니다.
  5. 권한에서 역할 선택을 클릭하고 메뉴에서 Vertex AI Platform Express 사용자를 선택합니다.
  6. 계속을 클릭합니다.
  7. 완료를 클릭합니다.

API 키 만들기

  1. API 및 서비스 > 사용자 인증 정보를 엽니다.
  2. 사용자 인증 정보 만들기 > API 키를 클릭합니다.
  3. 다음과 같이 API 키를 구성합니다.
    • 이름: vertexaiapikey
    • 서비스 계정을 통해 API 호출 인증: 선택됨
  4. 서비스 계정 선택을 클릭합니다.
  5. 이전 단계에서 만든 서비스 계정을 선택하고 선택을 클릭합니다.
  6. 만들기를 클릭합니다.

첫 번째 API 요청 실행

API 키를 가져온 후 API 빠른 시작에서 API 키를 사용하여 첫 번째 요청을 실행하는 방법을 알아보세요.

선택사항: 로컬에서 API 키 설정

초기 테스트의 경우 API 키를 하드코딩할 수 있지만 안전하지 않으므로 일시적으로만 하드코딩해야 합니다. 이 섹션의 나머지 부분에서는 다양한 운영체제에서 API 키를 로컬에서 환경 변수로 설정하는 방법을 설명합니다.

클릭하여 안내 펼치기

Linux/macOS

  1. 다음 명령어를 실행하여 사용 중인 명령줄 셸을 확인합니다.

    echo $SHELL

    출력은 다음과 비슷합니다.

    /bin/bash

  2. 다음 중 하나를 수행하여 API 키의 셸 내보내기 변수를 추가합니다.

    • 이전 단계 출력이 /bin/bash인 경우:

      1. .bashrc 열기:

        touch ~/.bashrc
        open ~/.bashrc

      2. .bashrc에 다음 줄을 추가합니다.

        export GEMINI_API_KEY=YOUR_API_KEY

      3. 파일을 저장한 후 다음을 실행하여 변경사항을 적용합니다.

        source ~/.bashrc

    • 이전 단계 출력이 /bin/zsh인 경우:

      1. .zshrc 열기:

        touch ~/.zshrc
        open ~/.zshrc

      2. .zshrc에 다음 줄을 추가합니다.

        export GEMINI_API_KEY= YOUR_API_KEY

      3. 파일을 저장한 후 다음을 실행하여 변경사항을 적용합니다.

        source ~/.zshrc

Windows

  1. 시스템 설정에서 '환경 변수'를 검색합니다.
  2. '사용자 변수'(현재 사용자의 경우) 또는 '시스템 변수'(모든 사용자의 경우 - 주의해서 사용)를 수정합니다.
  3. 변수를 만들고 export GEMINI_API_KEY=YOUR_API_KEY를 추가합니다.
  4. 변경사항 적용