Gemini API 키는 무료일까? 발급부터 한도 확인·첫 호출 준비까지

Gemini API 키는 Google AI Studio에서 만들 수 있고, 조건에 맞는 계정과 모델이라면 무료 등급(Free Tier) 으로 시작할 수 있습니다. 하지만 키 발급 자체가 모든 모델의 무제한 무료 사용을 뜻하지는 않습니다. 무료 대상은 모델과 기능에 따라 다르고, 요청 한도는 API 키가 아니라 프로젝트 단위로 적용됩니다.

따라서 “키가 만들어졌는가”만 확인하면 절반만 끝난 셈입니다. 실제로는 현재 가격표에서 사용할 모델이 무료 등급 대상인지 확인하고, AI Studio에서 해당 프로젝트의 활성 한도를 본 다음, 키를 안전하게 보관한 상태로 첫 요청을 보내야 합니다.

이 글은 특정 계정이 반드시 무료 등급을 쓸 수 있다거나 정해진 횟수만큼 호출할 수 있다고 보장하지 않습니다. 대신 지금 자신의 화면에서 답을 확인하는 순서를 안내합니다.

먼저 구분하기: 무료 키, 무료 등급, 무료 사용량은 다르다

검색할 때는 모두 “무료”로 보이지만 실제 판단 기준은 서로 다릅니다.

API 키는 Google Cloud 프로젝트와 연결됩니다. 한 프로젝트에 키를 여러 개 만들더라도 비율 제한이 키마다 새로 생기는 방식은 아닙니다. 공식 문서상 제한은 프로젝트 단위로 적용되므로, 키를 추가 발급해 한도를 늘리려는 접근은 맞지 않습니다.

또한 현재 Google 문서는 2026년 3월 이후 정책에 따라 발급된 Google Cloud 환영 또는 무료 체험 크레딧이 Gemini API나 AI Studio 사용료를 대신 내지 않는다고 안내합니다. 이전 계정의 특정 크레딧에는 예외가 있을 수 있으므로, “Cloud 무료 크레딧이 있으니 Gemini API도 자동으로 무료”라고 가정하지 말고 자신의 크레딧 약관을 확인해야 합니다.

1. 내 계정과 지역이 시작 조건에 맞는지 확인한다

대한민국은 Google AI Studio와 Gemini API의 공식 지원 지역 목록에 포함됩니다. 다만 지역 지원은 특정 계정, 모델, 기능, 한도 또는 결제 수단을 보장하지 않습니다. 회사나 학교의 관리형 Google 계정을 쓴다면 조직 정책 때문에 프로젝트 생성이나 키 발급 권한이 제한될 수도 있습니다.

시작 전에 다음 세 가지를 확인하세요.

1. 지원 지역 목록에 현재 접속 지역이 포함되는지 확인합니다.
2. 사용할 Google 계정으로 AI Studio에 로그인합니다.
3. 새 프로젝트를 만들지 기존 Google Cloud 프로젝트를 연결할지 결정합니다. 조직 계정이라면 프로젝트와 API 키 생성 권한도 함께 확인합니다.

이 단계에서 AI Studio가 로그인 화면으로 돌아가거나 프로젝트 선택을 막는다면, 무료 여부를 따지기 전에 계정·조직·지역 조건을 해결해야 합니다.

2. Google AI Studio에서 프로젝트와 API 키를 연결한다

공식 API 키 안내에 따르면 Gemini Developer API 요청에는 인증이 필요하며, AI Studio에서 API 키를 만들고 관리할 수 있습니다. 화면 문구는 바뀔 수 있지만 판단 순서는 간단합니다.

1. Google AI Studio의 API 키 화면을 엽니다.
2. 키와 연결할 Google Cloud 프로젝트를 확인하거나 선택합니다.
3. API 키를 생성한 뒤 어느 프로젝트에 연결되었는지 기록합니다.
4. 키 문자열은 비밀번호처럼 취급하고 서버 측 비밀정보 저장소로 옮깁니다.

여기까지 성공해도 아직 “무료 호출 가능”이 확인된 것은 아닙니다. 키는 요청을 인증하는 수단이고, 무료 대상과 사용 한도는 선택한 모델과 프로젝트 상태에서 따로 결정됩니다.

3. 무료 대상 모델과 프로젝트 활성 한도를 따로 확인한다

먼저 Gemini Developer API 가격표에서 사용할 모델을 찾고 Free Tier 열을 확인하세요. 일부 모델과 기능에는 무료 등급이 있지만 모든 모델과 기능이 무료인 것은 아닙니다. 모델 이름이나 무료 제공 범위는 바뀔 수 있으므로 블로그에 적힌 오래된 목록보다 현재 공식 표가 우선입니다.

그다음 AI Studio에서 같은 프로젝트의 활성 비율 제한을 확인합니다. Gemini API는 보통 다음 차원을 함께 사용합니다.

• RPM: 1분당 요청 수
• TPM: 1분당 처리 토큰 수
• RPD: 1일당 요청 수

요청 하나가 한 차원에서는 여유가 있어도 다른 차원의 한도에 걸릴 수 있습니다. 예를 들어 RPM이 남아 있어도 긴 입력 때문에 TPM을 먼저 소진할 수 있습니다. 반대로 짧은 요청을 빠르게 반복하면 RPM에 먼저 닿을 수 있습니다.

중요한 점은 공개된 숫자나 화면에 표시된 한도가 실제 처리 용량을 보장하지 않는다는 것입니다. 모델과 사용 등급에 따라 값이 다르며 변경될 수 있습니다. 그래서 “무료로 하루 몇 번 쓸 수 있나”에 대한 보편적인 숫자는 없습니다. 현재 AI Studio에 표시된 프로젝트·모델별 활성 한도를 출발점으로 삼고, 애플리케이션에서는 429 응답을 정상적인 운영 조건으로 처리해야 합니다.

429가 나오면 키를 새로 만들기 전에 볼 것

429 응답은 새 키가 필요하다는 뜻으로 단정할 수 없습니다. 먼저 다음을 확인하세요.

• 요청에 사용한 모델과 AI Studio에서 확인한 모델이 같은가
• 해당 모델의 RPM·TPM·RPD 중 어떤 차원에 도달했는가
• 여러 키나 서비스가 같은 프로젝트 한도를 공유하고 있지 않은가
• 재시도 간격을 두고 지수 백오프를 적용했는가
• 실제로 유료 등급이 필요한 사용량인지, 아니면 요청 크기나 빈도를 줄일 수 있는가

4. 결제와 데이터 처리 조건을 호출 전에 판단한다

조건에 맞는 신규 계정은 무료 등급으로 시작할 수 있지만, 유료 등급으로 이동하려면 Cloud Billing이 필요합니다. 결제 방식, 선불·후불 여부, 최소 충전액, 업그레이드 화면은 계정과 지역에 따라 달라질 수 있습니다. 따라서 “카드가 항상 필요 없다”거나 “카드만 등록하면 바로 유료 등급이 된다”고 일반화하면 안 됩니다.

데이터 처리 조건도 무료와 유료를 같다고 보면 안 됩니다. 현재 공식 가격표는 무료 등급에서 전송한 콘텐츠가 Google 제품 개선에 사용될 수 있다고 설명하고, 유료 등급 콘텐츠는 제품 개선에 사용하지 않는다고 구분합니다. 다만 이 차이만으로 개인정보·기밀정보·규제 대상 데이터의 적합성을 판단할 수는 없습니다. 민감한 데이터를 보낼 계획이라면 최신 약관과 조직의 보안·법무 기준을 별도로 검토하세요.

5. API 키를 코드 밖에 두고 첫 요청을 준비한다

Google은 Gemini API 키를 비밀번호처럼 취급하라고 안내합니다. 공개 Git 저장소, 프런트엔드 번들, 모바일 앱 코드, 스크린샷, 오류 로그에 키를 넣지 마세요. 브라우저나 앱에서 직접 Gemini API를 호출하면 사용자가 키를 추출할 수 있으므로, 실제 서비스에서는 서버 측에서 호출하고 비밀정보 관리 기능에 키를 보관하는 편이 안전합니다.

로컬 개발에서는 키를 환경변수 GEMINI_API_KEY로 저장합니다. 셸 기록에 키가 남지 않도록 주의하고, .env 파일을 쓴다면 Git 추적 대상에서 제외하세요. 이미 노출했다면 저장소에서 문자열만 지우는 것으로 끝내지 말고 해당 키를 폐기한 뒤 새 키를 발급해야 합니다.

첫 호출 코드는 공식 빠른 시작 안내에서 현재 언어별 예제를 가져오는 것이 가장 안전합니다. SDK 버전, 권장 API 방식, 모델 식별자와 샘플 문법은 바뀔 수 있기 때문입니다. Python, JavaScript 또는 REST 중 자신의 환경을 선택한 뒤 다음 순서로 검증하세요.

1. 공식 빠른 시작 안내에 나온 현재 SDK와 예제를 사용합니다.
2. 키를 소스 코드에 직접 쓰지 않고 GEMINI_API_KEY에서 읽게 합니다.
3. 가격표에서 확인한 모델과 예제의 모델이 일치하는지 다시 봅니다.
4. 민감하지 않은 짧은 테스트 입력으로 한 번 요청합니다.
5. 성공 응답이면 모델명과 프로젝트를 기록하고, 실패하면 HTTP 상태와 오류 메시지를 기준으로 계정·모델·한도·인증을 나눠 점검합니다.

이 글에서는 인증된 Google 계정이나 실제 API 키로 요청을 보내지 않았습니다. 따라서 특정 계정에서 같은 화면이 보이거나 요청이 성공한다고 주장하지 않습니다. 첫 호출의 최종 증거는 독자 자신의 프로젝트에서 받은 응답입니다.

첫 호출 전 60초 최종 점검

아래 질문에 모두 답할 수 있으면 무료 시작 조건을 비교적 명확하게 파악한 것입니다.

• API 키가 어느 Google Cloud 프로젝트에 연결되어 있는가?
• 사용할 모델이 현재 공식 가격표에서 무료 등급 대상인가?
• AI Studio에 표시된 해당 프로젝트·모델의 활성 RPM·TPM·RPD는 얼마인가?
• Cloud 크레딧과 Gemini API 무료 등급을 별개로 확인했는가?
• 무료 등급의 콘텐츠 처리 조건이 내 데이터에 적합한가?
• 키가 환경변수 또는 서버 측 비밀정보 저장소에 있고 공개 코드에는 없는가?
• 첫 요청이 실패했을 때 인증, 무료 등급 대상 여부, 비율 제한, 결제 문제를 구분해 볼 수 있는가?

핵심은 간단합니다. Gemini API 키를 만드는 것은 시작점이고, 무료 사용 가능 여부는 모델·프로젝트·계정의 현재 상태에서 확인해야 합니다. 고정된 무료 호출 수를 외우기보다 공식 가격표와 AI Studio의 활성 한도를 함께 보고, 키를 안전하게 보관한 뒤 현재 빠른 시작 안내에 따라 짧은 요청으로 검증하세요.