이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Gemini 시작하기

이 페이지는 개발자가 Gemini 모델을 사용하기 위해 Google Distributed Cloud (GDC) 에어 갭 프로젝트를 설정하는 데 도움이 됩니다. 이 과정에는 프로젝트 만들기, Gemini API 사용 설정, 클라이언트 라이브러리 설치, 환경 변수 정의, 사용자 인증 정보 인증이 포함됩니다. Gemini를 처음 사용하는 경우 Gemini 기능에 대해 자세히 알아보세요.

다음과 같이 GDC 콘솔과 gdcloud CLI를 사용하여 Gemini를 시작합니다.

GDC 콘솔: Gemini API를 사용 설정하고 모델 상태와 엔드포인트를 확인합니다.
gdcloud CLI: 서비스 계정을 구성하고, 클라이언트 라이브러리를 설치하고, API 요청을 인증합니다.

프로젝트 만들기

Distributed Cloud 리소스 계층 구조 내에서 프로젝트를 만들면 공동작업자, 사용 설정된 API, 인증 사용자 인증 정보, 액세스 제어를 비롯한 리소스가 구성됩니다.

Gemini는 GDC의 Vertex AI에서 제공하는 생성형 AI 모델 중 하나입니다. 따라서 프로젝트를 만들려면 Vertex AI용 프로젝트 설정을 참고하세요. API를 호출할 때는 프로젝트 ID가 필요합니다.

개발자 권한 요청

Gemini 기능에 액세스하고 요청 인증 및 승인을 위한 API 토큰을 생성하려면 프로젝트에 적절한 역할이 있어야 합니다.

프로젝트 IAM 관리자에게 프로젝트 네임스페이스 내의 사용자 또는 서비스 계정에 연결된 Gemini 역할 중 하나를 부여해 달라고 요청하세요. Gemini 역할에 대한 자세한 내용은 IAM 권한 준비를 참고하세요.

Gemini API 사용 설정

프로젝트에 Gemini API를 사용 설정해야 합니다. 사용 설정하면 Gemini API의 서비스 상태와 엔드포인트를 볼 수 있습니다.

클라이언트 라이브러리 설치

Python 프로그래밍 언어용 클라이언트 라이브러리가 제공됩니다. 이러한 클라이언트 라이브러리를 사용하면 API에 더 쉽게 액세스할 수 있으므로 Gemini API를 호출하는 것이 좋습니다.

OpenAI 호환 Python SDK를 사용하려면 OpenAI SDK 및 기타 필수 Python 라이브러리를 설치하세요.

pip install openai
pip install absl-py
pip install typing
pip install protobuf

환경 변수 설정

클라이언트 라이브러리를 설치한 후 Python 스크립트에서 API와 상호작용할 수 있습니다.

프로젝트에서 서비스 계정을 설정하여 프로그래매틱 방식으로 승인된 API를 호출하는 경우 Python 스크립트에서 환경 변수를 정의하여 서비스 계정 키와 같은 값에 액세스할 수 있습니다.

다음 단계에 따라 Python 스크립트에서 필수 환경 변수를 설정하세요.

Python 스크립트를 만듭니다.
Python 스크립트에 다음 코드를 추가합니다.
프로덕션
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
```
APPLICATION_DEFAULT_CREDENTIALS_FILENAME를 프로젝트에서 생성한 서비스 계정 키가 포함된 JSON 파일의 이름(예: my-service-key.json)으로 바꿉니다.
개발
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
os.environ["GRPC_DEFAULT_SSL_ROOTS_FILE_PATH"] = "CERT_NAME"
```
다음을 바꿉니다.
- APPLICATION_DEFAULT_CREDENTIALS_FILENAME: 프로젝트에서 생성한 서비스 계정 키가 포함된 JSON 파일의 이름입니다(예: my-service-key.json).
- CERT_NAME: 인증 기관(CA) 인증서 파일의 이름(예: org-1-trust-bundle-ca.cert) 자세한 내용은 개발 환경에서 신뢰 번들 CA 인증서 파일 생성을 참고하세요.
Python 스크립트를 이름과 함께 저장합니다.
Python 스크립트를 실행하여 환경 변수를 설정합니다.
```
python SCRIPT_NAME
```
SCRIPT_NAME을 Python 스크립트에 지정한 이름으로 바꿉니다.

인증 설정

Gemini API를 사용하려면 먼저 클라이언트 사용자 인증 정보를 인증하고 프로젝트 리소스에 대한 계정 액세스를 요청해야 합니다. 자세한 내용은 API 요청 인증을 참고하세요.