제미나이 API 키 발급 방법, 계정 준비부터 키 관리까지

자동화 프로그램에 제미나이를 연결하려는데 API 키를 넣으라는 칸이 나타납니다. 평소 쓰는 Gemini 앱에 로그인한 계정과 같은 것일까요?

API 키는 프로그램이 Gemini API를 호출할 때 사용하는 인증 정보입니다. 발급과 관리는 Google AI Studio에서 하며, 키가 속한 Google Cloud 프로젝트의 이용 한도와 결제 상태도 함께 확인해야 합니다. 앱에서 대화하는 것과 프로그램에서 API를 호출하는 것은 이용 경로가 다릅니다.

1. AI Studio에 로그인하고 이용 조건을 확인합니다

Google AI Studio에 사용할 Google 계정으로 로그인합니다. 처음 이용하면 약관이나 계정 이용 조건 확인이 나타날 수 있습니다. 학교·회사 계정처럼 조직이 관리하는 계정은 관리자 정책과 프로젝트 권한의 영향도 받습니다.

접속이 안 된다면 계정과 지역의 이용 가능 조건부터 확인합니다. 공식 지원 지역 목록에는 대한민국이 포함돼 있지만, 이것만으로 모든 계정의 접근이 보장되는 것은 아닙니다.

2. 키를 넣을 프로젝트를 먼저 정합니다

Gemini API 키는 Google Cloud 프로젝트에 속합니다. 프로젝트는 이 API를 쓰는 작업의 묶음으로 생각하면 됩니다. 어떤 키로 썼는지뿐 아니라 어느 프로젝트의 한도와 비용에 반영되는지가 중요합니다.

현재 공식 안내에 따르면, 새 이용자는 약관에 동의한 뒤 기본 프로젝트와 키가 자동으로 만들어질 수 있습니다. 이미 Google Cloud 계정을 사용하는 경우에는 사용할 프로젝트를 AI Studio로 가져오는 과정이 필요할 수 있습니다.

기존 프로젝트를 쓰려면 대시보드의 프로젝트(Projects) → 프로젝트 가져오기(Import projects)에서 대상을 선택합니다. 목록에 없다고 무조건 새 프로젝트를 만들기보다, 지금 로그인한 계정과 해당 프로젝트의 접근 권한을 먼저 확인합니다.

3. API 키 화면에서 발급합니다

2026년 11월 확인한 AI Studio의 키 관리 화면에는 왼쪽 API 키 메뉴와 오른쪽 위 API 키 만들기 버튼이 있습니다. 발급할 때의 순서는 다음과 같습니다.

1. API 키 관리 화면을 엽니다.
2. 기본 키가 이미 있다면 소속 프로젝트부터 확인합니다. 별도 키가 필요하면 API 키 만들기를 선택합니다.
3. 사용할 프로젝트와 화면에서 요구하는 항목을 확인해 생성을 진행합니다.
4. 발급된 키를 연결할 프로그램의 비밀키 설정에 입력합니다. 공개 문서나 화면 공유에 복사하지 않습니다.

버튼이 비활성화되거나 권한 오류가 나타나면 프로젝트 관리자에게 키 생성 권한을 확인해야 합니다.

또 현재 공식 문서는 2026년 5월 28일부터 AI Studio에서 만드는 새 키가 인증 키(auth key)로 생성된다고 안내합니다. 이전의 표준 키와 권한 구조가 다르므로, 오래된 예제의 키 설정을 그대로 따라가기보다 현재 화면과 안내를 기준으로 확인하는 편이 좋습니다.

4. 키 발급과 무료 이용을 같은 뜻으로 보지 않습니다

키가 발급됐다고 모든 모델과 기능을 무료로 무제한 사용할 수 있는 것은 아닙니다. Gemini API 과금 안내에 따르면 키는 프로젝트의 결제 상태와 이용 등급을 따르며, 무료 제공 범위와 한도는 사용하는 모델 등에 따라 달라집니다.

실제로 연결하기 전에는 선택한 프로젝트의 무료·유료 상태, 사용할 모델의 요금과 요청 한도를 확인합니다. Gemini 앱의 구독 화면만 보고 API 이용 조건까지 판단하지 말고, AI Studio의 프로젝트와 사용량·결제 화면에서 확인해야 합니다.

5. 키는 비밀번호처럼 보관합니다

Google은 키를 코드 저장소에 올리거나 배포용 웹·모바일 앱 안에 그대로 넣지 말라고 안내합니다. 다른 사람이 키를 가져가면 내 프로젝트의 한도를 사용하거나 비용을 발생시킬 수 있습니다.

로컬 프로그램에서는 환경 변수나 프로그램이 제공하는 비밀키 저장 기능을 사용합니다. 공식 라이브러리는 GEMINI_API_KEY 또는 GOOGLE_API_KEY 환경 변수를 인식하며, 둘 다 설정돼 있으면 GOOGLE_API_KEY가 우선합니다. 실제 서비스에서는 서버에서 키를 관리하고 호출하는 구성이 필요합니다.

노출이 의심되면 새 키를 준비해 프로그램의 연결을 바꾸고 정상 동작을 확인한 뒤, 노출된 키를 중지하거나 삭제하고 사용량을 살펴봅니다. 발급된 문자열만 챙기는 것이 아니라, 소속 프로젝트·비용·보관 위치까지 확인해야 연결 준비가 끝납니다.