API 키 발급과 .env 파일

한 줄 요약

Google AI Studio에서 Gemini API 키를 발급받아, 프로젝트 폴더의 .env 파일에 넣습니다. API 키는 비밀번호와 같습니다. 코드에 직접 적지 않습니다.

1. API와 API 키

API(Application Programming Interface) 는 프로그램이 다른 프로그램의 기능을 불러 쓰는 통로입니다. 우리 코드는 Gemini API라는 통로로 구글의 LLM에 질문을 보내고 답을 받습니다.

API 키는 "이 요청은 누구의 것인가"를 알려 주는 긴 문자열입니다. 요금이 이 키의 주인에게 청구됩니다.

2. API 키 발급

https://aistudio.google.com/apikey 에 접속해 구글 계정으로 로그인합니다.
API 키 만들기(Create API key) 를 누릅니다. 프로젝트를 묻는 화면이 나오면 새 프로젝트 만들기를 고릅니다.
AIza로 시작하는 긴 문자열이 나옵니다. 복사해 둡니다.

요청 한도에 대하여. 이 과정의 기본 모델 gemini-3.8-flash는 무료 등급으로도 호출할 수 있습니다. 다만 무료 등급은 분당·일일 요청 수 제한이 낮아, 여러 번 호출하는 실습에서 429 오류(요청 한도 초과)를 만날 수 있습니다. 그럴 때는 잠시 기다렸다가 다시 실행하거나, AI Studio의 결제(Billing) 메뉴에서 결제 계정을 연결해 유료 등급으로 씁니다.

3. .env 파일 만들기

프로젝트 폴더에는 양식 파일 .env.example이 들어 있습니다. 이것을 복사해 .env를 만듭니다. VS Code 터미널에서 입력합니다.

$ cp .env.example .env

VS Code 왼쪽 탐색기에 .env 파일이 생깁니다. 눌러서 열면 아래 내용이 보입니다.

# 이 파일을 .env 로 복사한 뒤 본인의 키를 넣으세요.
#   cp .env.example .env
# .env 는 절대 git에 커밋하지 않습니다 (.gitignore 등록됨)

# Google AI Studio (https://aistudio.google.com/apikey) 에서 발급
GOOGLE_API_KEY=여기에_발급받은_키_붙여넣기

# 수업 기본 모델
GEMINI_MODEL=gemini-3.8-flash

# 임베딩 모델 (13장 이후 RAG에서 사용)
GEMINI_EMBEDDING_MODEL=models/gemini-embedding-001

GOOGLE_API_KEY 줄에서 = 뒤의 여기에_발급받은_키_붙여넣기를 지우고, 그 자리에 방금 복사한 키를 붙여 넣습니다. #으로 시작하는 줄은 설명이라 고치지 않습니다.

주의할 점 세 가지.

= 앞뒤에 공백을 넣지 않습니다.
키를 따옴표로 감싸지 않습니다.
고친 뒤 저장합니다(Ctrl + S). 저장하지 않으면 빈 키로 실행됩니다.

아래 두 줄(GEMINI_MODEL, GEMINI_EMBEDDING_MODEL)은 그대로 둡니다.

4. 왜 코드가 아니라 .env에 두는가

API 키를 가진 사람은 누구든 여러분 계정으로 모델을 호출할 수 있고, 요금은 여러분에게 청구됩니다. 그런데 가장 흔한 사고가 코드에 키를 적은 채로 GitHub 같은 공개 저장소에 올리는 것입니다. 공개된 키는 자동 수집 프로그램이 몇 분 안에 찾아내 도용합니다.

그래서 이렇게 나눕니다.

파일	담는 것	공유
코드(`.py`)	동작	공유해도 됩니다
`.env`	키, 모델 이름 같은 설정	절대 공유하지 않습니다

코드는 .env를 읽어 값을 가져옵니다. 제공된 config.py가 그 일을 합니다. 그래서 실습 파일에는 키가 한 글자도 나오지 않습니다.

덤으로 얻는 것이 하나 있습니다. 모델 이름도 .env에 있으므로, 코드를 고치지 않고 .env의 한 줄만 바꿔 모델을 교체할 수 있습니다.

화면 공유 중에는 .env 파일을 열어 두지 마세요. 한 번이라도 남에게 보인 키는 유출된 것으로 보고, AI Studio에서 지운 뒤 새로 발급받습니다.

핵심 정리

Gemini API 키는 https://aistudio.google.com/apikey 에서 발급받습니다.
cp .env.example .env 로 .env를 만들고 GOOGLE_API_KEY에 키를 넣어 저장합니다.
API 키는 비밀번호입니다. 코드에 적지 않고, 공유하지 않습니다.
설정을 .env에 두면 코드를 고치지 않고 모델을 교체할 수 있습니다.