Google Gemini API 생성 방법

Google Gemini API 생성 방법

Google Gemini API 생성 방법

Google Gemini API 생성 방법 블로그

1. Google Cloud 프로젝트 생성

Gemini API를 사용하려면 먼저 Google Cloud Platform(GCP)에서 프로젝트를 생성해야 합니다.

무료로 시작하기를 선택하여 계정을 생성하세요.

• 생성된 Google Cloud Console에 로그인하고 우측 상단의 콘솔(Console)을 선택합니다.
• 왼쪽 상단의 프로젝트 드롭다운에서 ’프로젝트 만들기’를 클릭합니다.
• 프로젝트 이름을 입력하고, 조직을 선택한 후 ’만들기’를 클릭합니다.

왼쪽 상단의 점 세개 모양의 아이콘을 선택하면 프로젝트 선택 팝업 창에서 새 프로젝트 버튼을 클릭하여 프로젝트 생성이 가능합니다.

2. 결제 설정

API를 사용하려면 결제 계정을 연결해야 합니다.

• ‘결제’ 메뉴에서 결제 계정을 생성하거나 기존 계정을 연결합니다.
• 프로젝트에 결제 계정이 연결되어 있는지 확인합니다.

3. Gemini API 활성화

• Google Cloud Console에서 ’API 및 서비스 > 라이브러리’로 이동합니다.
• 검색창에 ‘Gemini API’를 입력하고, 결과에서 선택한 후 ‘사용’ 버튼을 클릭합니다.

4. 서비스 계정 생성 및 키 발급

API를 안전하게 사용하려면 서비스 계정을 생성하고 인증키를 발급받아야 합니다.

• ‘IAM 및 관리자 > 서비스 계정’ 메뉴로 이동합니다.
• ’서비스 계정 만들기’를 클릭하고, 이름과 설명을 입력합니다.

• 서비스 계정이 생성되면, Google AI Studio에서 API 키 만들기를 선택하여 키를 생성합니다. 키 생성을 위한 프로젝트는 처음 생성한 프로젝트 또는 키를 사용하기 위한 프로젝트를 선택하세요. 키 제한사항을 Generative Language API로 제한된 API 키를 생성할 수 있습니다.

5. Gemini API 모델 및 결제정보

[Gemini API 문서](https://ai.google.dev/gemini-api/docs?hl=ko) 사이트에서 API로 사용가능한 Gemini API 모델과 가격정책을 확인할 수 있습니다.

아래 표는 Gemini API에서 제공하는 주요 모델과 각 모델별 가격 정보를 정리한 것입니다. 모든 가격은 유료(유상) API 기준이며, 무료 티어(Free Tier)는 대부분 테스트 용도로 제공되고, 일부 모델에 한해 무료 사용이 가능합니다. 가격은 상시 변경될 수 있으니 최신 정보는 꼭 사이트를 통해서 확인이 필요합니다.

모델명	주요 특징/용도	입력 가격 (1M 토큰)	출력 가격 (1M 토큰)	기타/비고
Gemini 2.5 Flash Preview	하이브리드 추론, 1M 토큰 컨텍스트	$0.15 (텍스트/이미지/비디오) $1.00 (오디오)	$0.60 (Non-thinking) $3.50 (Thinking)	컨텍스트 캐싱: $0.0375 (텍스트/이미지/비디오), $0.25 (오디오) 무료 등급 제공 (최대 500 PRD)
Gemini 2.5 Pro Preview	고급 추론, 복잡한 코딩/분석	$1.25 (≤200k 토큰) $2.50 (>200k 토큰)	$10.00 (≤200k 토큰) $15.00 (>200k 토큰)	컨텍스트 캐싱: $0.31/$0.625
Gemini 2.5 Flash Native Audio	고품질 오디오 대화	$0.50 (텍스트) $3.00 (오디오/비디오)	$2.00 (텍스트) $12.00 (오디오)
Gemini 2.5 Flash Preview TTS	저지연 텍스트-음성 변환	$0.50 (텍스트)	$10.00 (오디오)	무료 등급 제공
Gemini 2.5 Pro Preview TTS	고성능 텍스트-음성 변환	$1.00 (텍스트)	$20.00 (오디오)
Gemini 2.0 Flash	균형 잡힌 멀티모달, 1M 토큰	$0.10 (텍스트/이미지/비디오) $0.70 (오디오)	$0.40	이미지 생성: $0.039/장
Gemini 2.0 Flash-Lite	저비용, 대규모 처리용	$0.075	$0.30
Gemini 1.5 Flash	빠른 멀티모달, 반복 작업	$0.075 (≤128k 토큰) $0.15 (>128k 토큰)	$0.30 (≤128k 토큰) $0.60 (>128k 토큰)
Gemini 1.5 Flash-8B	저지능, 대량 처리	$0.0375 (≤128k 토큰) $0.075 (>128k 토큰)	$0.15 (≤128k 토큰) $0.30 (>128k 토큰)
Gemini 1.5 Pro	2M 토큰, 고지능 추론	$1.25 (≤128k 토큰) $2.50 (>128k 토큰)	$5.00 (≤128k 토큰) $10.00 (>128k 토큰)
Imagen 3	텍스트-이미지 생성	$0.03 (1장)	-
Veo 2	텍스트/이미지-비디오 생성	$0.35 (1초)	-

• 모든 가격은 1M(100만) 토큰 단위 기준이며, 일부 모델은 입력/출력 토큰 수에 따라 가격이 다릅니다.

• 이미지 생성(Imagen 3)은 1장당 $0.03, 비디오 생성(Veo 2)은 1초당 $0.35입니다.

• 무료 티어는 일부 모델에서만 제공되며, 무료 티어는 주로 테스트 용도로 사용 가능합니다.

• Gemini API의 각 모델은 입력 데이터 타입(텍스트, 이미지, 오디오, 비디오)과 지원 기능, 토큰 한도, 최적화 용도가 다르므로 사용 목적에 맞는 모델 선택이 중요합니다1.

5. Gemini API 엔드포인트 확인

API 문서에서 제공하는 엔드포인트 URL을 확인합니다. 일반적으로 REST API 방식으로 호출할 수 있습니다.

6. API 호출 예시

Python을 예시로, Gemini API를 호출하는 기본 코드는 다음과 같습니다. google의 genai 패키지를 python3.9이상 버전에 설치합니다.

pip install -q -U google-genai

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents="Explain how AI works in a few words",
)

print(response.text)

7. 사용량 및 비용 관리

• Google Cloud Console의 ’API 및 서비스 > 사용량’에서 요청 현황을 확인할 수 있습니다.
• 비용이 예상보다 높아지지 않도록 알림 및 한도를 설정하는 것이 좋습니다.

카테고리 다른 글