Gemini API 키 발급 및 시스템 환경 변수 설정 절차

Gemini API 인증 환경과 계정별 조건

Gemini API를 프로젝트에 적용하려면 Google AI Studio에서 전용 인증 키를 발급받아 시스템 환경 변수로 등록해야 합니다. 소스코드 내부에 API 키를 직접 작성하면 저장소 공유 시 보안 문제가 발생하므로 환경 변수를 참조하는 방식을 권장합니다.

계정 유형과 운영 환경에 따라 키 발급 절차와 권한 조건이 다릅니다. 작업 전에 아래 계정 조건표를 대조하여 권한 승인 여부를 확인합니다.

개인 계정인 경우에는 Google AI Studio 웹사이트에 접속하여 키를 생성합니다. 조직 계정인 경우에는 계정 관리자에게 Google Cloud API 및 서비스 메뉴의 접근 승인을 먼저 요청합니다.

환경 변수를 설정할 때 변수 이름은 GEMINI_API_KEY를 사용합니다. 설정된 키를 소스코드에서 불러오는 방식을 사용하면 인증 정보를 노출하지 않고 안전하게 모델을 호출할 수 있습니다.

다음은 Windows 명령어 프롬프트 전용 환경 변수 등록 명령과 Python 연동 코드 예시입니다.

setx GEMINI_API_KEY "YOUR_GEMINI_API_KEY_HERE"

import os import google.generativeai as genai

api_key = os.environ.get("GEMINI_API_KEY") genai.configure(api_key=api_key)

model = genai.GenerativeModel('gemini-1.5-flash') response = model.generate_content("Hello World") print(response.text)

위 연동 예시를 사용할 때 YOUR_GEMINI_API_KEY_HERE 부분을 실제 발급받은 키 문자열로 교체하여 명령을 실행합니다. 코드 실행 후 터미널에 응답 텍스트가 출력되는지 확인합니다.

인증 키 발급 및 시스템 변수 등록은 Google AI Studio 화면과 Windows 시스템 설정 메뉴에서 진행합니다.

등록을 완료한 후에는 실행 중이던 명령어 프롬프트나 개발 에디터를 종료하고 다시 열어야 변경된 환경 변수가 적용됩니다.

발급받은 API 키는 Git 저장소나 외부 웹서버에 업로드되지 않도록 주의해야 합니다. 인증 키가 공개 저장소에 유출되면 제3자가 사용량을 소비하여 계정 한도가 초과될 수 있습니다.

프로젝트 루트 폴더에 .gitignore 파일을 생성하고 해당 파일 안에 .env 문자열을 추가합니다. 환경 변수를 .env 파일로 별도 관리하는 경우 해당 파일이 버전 관리 대상에 포함되지 않도록 설정합니다.

소스코드 안에는 API 키 문자열을 주석이나 문자열 상수로 남기지 않습니다. 팀 프로젝트를 진행할 때는 키 자체를 공유하지 않고 개별 환경 변수를 각자 등록하도록 안내합니다.

키 등록 후 소스코드를 실행했을 때 오류가 발생하면 터미널 오류 메시지를 확인하여 조치합니다.

API_KEY_INVALID 오류가 발생하는 경우에는 변수 값에 공백이나 오타가 포함되었는지 확인합니다. 변수 이름을 오기한 경우에는 os.environ.get("GEMINI_API_KEY") 호출 부분의 문자열을 대소문자까지 동일하게 수정합니다.

403 Forbidden 오류가 출력되는 경우에는 조직 계정의 API 접근 권한이 제한된 상태입니다. Google Cloud 콘솔의 API 및 서비스 메뉴에서 Generative Language API가 활성화되어 있는지 확인하거나 개인 계정으로 전환하여 실행합니다.

등록이 정상적으로 완료된 환경에서는 터미널에서 echo %GEMINI_API_KEY% 명령을 실행했을 때 설정한 키 문자열이 터미널 화면에 정상 출력됩니다.