Gemini API 키 무료 발급 방법｜구글 AI 스튜디오 사용법·429 오류 해결

AI 프로그램을 설치하거나 간단한 자동화 도구를 연결하다 보면 'Gemini API 키를 입력하세요'라는 안내가 나올 때가 있습니다. 구글 계정으로 로그인하는 것과 달리 API 키는 어디서 발급받아야 하는지, 무료로 사용할 수 있는지 헷갈리기 쉽습니다. Gemini API 키는 Google AI Studio에서 발급받을 수 있습니다. 다만 키를 무료로 만드는 것과 AI 모델을 무료로 사용하는 것은 구분해야 합니다. 실제 발급 과정과 무료 사용 조건, 자주 발생하는 오류를 정리했습니다.

1. Gemini API 키는 어디에 사용할까?

Gemini API는 구글의 AI 모델을 외부 프로그램이나 직접 만든 서비스에서 사용할 수 있도록 연결하는 기능입니다. API 키는 이러한 요청이 어느 프로젝트에서 발생했는지 확인하고 사용량과 접근 권한을 관리하는 인증 정보입니다.

예를 들어 직접 만든 프로그램에서 Gemini로 문장을 요약하거나, 업무 자동화 도구에서 AI 응답을 생성하려면 API 연결이 필요할 수 있습니다. 반면 제미나이 웹사이트에 접속해 일반적인 채팅을 하는 데는 별도의 API 키를 발급받을 필요가 없습니다. AI 채팅 서비스 이용과 개발용 API 사용은 서로 다른 방식입니다.

2. 구글 AI 스튜디오에서 API 키 발급받기

먼저 Google AI Studio 바로가기에 접속합니다. 구글 계정으로 로그인한 뒤 처음 이용하는 경우 서비스 약관 동의 절차를 진행합니다.

① AI Studio 로그인: Google AI Studio에 접속해 자신의 구글 계정으로 로그인합니다.

② 대시보드 열기: 왼쪽 메뉴의 Dashboard 또는 대시보드를 선택합니다.

③ API Keys 선택: 대시보드에서 API 키 관리 메뉴를 엽니다.

④ 키 확인 또는 생성: 처음 가입한 계정은 기본 프로젝트와 API 키가 자동으로 생성되어 있을 수 있습니다. 새 키가 필요하다면 'Create API key'를 선택합니다.

⑤ 프로젝트 연결: 화면 안내에 따라 프로젝트를 선택하거나 생성한 뒤 API 키를 확인하고 안전한 곳에 보관합니다.

이미 생성된 키가 있다면 무조건 새로 만들 필요는 없습니다. API 키 목록에서 연결된 프로젝트와 상태를 먼저 확인하세요. 키마다 연결된 프로젝트가 있으며 실제 이용량과 결제 상태는 해당 프로젝트의 정책을 따릅니다.

3. Gemini API는 정말 무료일까?

Google AI Studio에서는 API 키를 발급받고 무료 사용 한도가 제공되는 AI 모델을 이용할 수 있습니다. 하지만 모든 Gemini 모델이 무료인 것은 아닙니다. 모델 종류와 프로젝트 상태에 따라 무료 이용 가능 여부와 요청 횟수가 달라집니다.

무료로 테스트하려면 API 키를 발급받은 뒤 AI Studio의 Projects 메뉴에서 해당 프로젝트의 Billing Tier가 Free인지 확인하는 것이 좋습니다. 일부 계정이나 프로젝트는 무료 API 사용 자격이 제한될 수 있습니다. 또한 무료 프로젝트라고 해서 모든 기능을 제한 없이 사용할 수 있는 것은 아닙니다.

유료 API를 사용하려면 별도로 결제 계정을 연결하는 과정이 필요합니다. 이미 결제가 활성화된 프로젝트에서 유료 모델을 사용하면 실제 요청량에 따라 비용이 발생할 수 있으므로, 테스트용이라면 무료 프로젝트를 별도로 관리하는 편이 안전합니다.

4. API 키를 발급받았는데 어디에 입력할까?

API 키는 구글 AI 모델을 사용하는 프로그램에서 요청할 때 입력합니다. 직접 개발한 프로그램이라면 서버의 환경 변수에 GEMINI_API_KEY라는 이름으로 등록해 사용할 수 있습니다. 구글 공식 개발 도구도 이 환경 변수 방식을 지원합니다.

외부 자동화 프로그램에 키를 연결할 때는 서비스의 운영 주체와 개인정보 처리 방식을 확인해야 합니다. 특히 인터넷에 공개되는 HTML·JavaScript 코드 안에 API 키를 직접 적거나, 다른 사람이 접근할 수 있는 저장소에 올리는 것은 피해야 합니다. 키를 입력하는 화면이 있다고 해서 모든 사이트가 안전한 것은 아닙니다.

5. API 사용량과 무료 한도 확인 방법

API를 처음 사용한다면 남은 이용량을 확인하는 방법도 알아두는 것이 좋습니다. Google AI Studio 대시보드의 'Usage'에서 사용 내역을 확인하고, 'Rate Limits' 메뉴에서는 모델별 요청 한도를 살펴볼 수 있습니다.

Gemini API의 이용 제한은 일반적으로 분당 요청 수(RPM), 분당 입력 토큰 수(TPM), 하루 요청 수(RPD) 등을 기준으로 적용됩니다. 여기서 토큰은 AI가 처리하는 텍스트의 단위를 뜻합니다. 짧은 질문을 여러 번 보내는 경우와 긴 문서를 한 번에 보내는 경우에는 사용량이 다르게 계산될 수 있습니다.

이러한 한도는 API 키 하나가 아니라 프로젝트를 기준으로 적용됩니다. 따라서 같은 프로젝트에서 키를 여러 개 만들더라도 무료 한도가 각각 새로 생기는 것은 아닙니다. 정확한 횟수는 사용 중인 모델과 프로젝트의 Rate Limits 화면에서 확인하세요.

6. Gemini API 429 오류 해결 방법

API를 연결했는데 '429 RESOURCE_EXHAUSTED' 또는 'Too Many Requests' 오류가 나타난다면 요청 횟수나 토큰 사용량 등의 한도를 초과했을 가능성이 있습니다. 짧은 시간에 너무 많은 요청을 보내거나 하루 사용량을 모두 소진했을 때 발생할 수 있습니다.

먼저 AI Studio의 Rate Limits에서 해당 모델의 제한을 확인하세요. 짧은 시간에 요청이 몰린 경우에는 잠시 후 재시도하고, 반복해서 호출하는 프로그램이라면 요청 간격을 늘리는 것이 좋습니다. 일일 한도를 소진했다면 한도가 초기화될 때까지 기다려야 할 수 있습니다. 같은 프로젝트에서 API 키만 다시 발급받는다고 이용 한도가 초기화되지는 않습니다.

7. API 키가 작동하지 않을 때 확인할 사항

401 인증 오류: API 키가 누락되었거나 올바르지 않을 수 있습니다. 프로그램에 입력된 키와 AI Studio의 키 상태를 확인하세요. 키 앞뒤에 불필요한 공백이 들어가 있지는 않은지도 점검합니다.

403 권한 오류: 프로젝트에 필요한 권한이 없거나 API 이용 자격이 제한된 경우 발생할 수 있습니다. 프로젝트의 Billing Tier, 권한, API 키 차단 여부를 확인하세요. 무료 사용이 제한된 프로젝트라면 같은 프로젝트에서 키를 다시 만들어도 해결되지 않을 수 있습니다.

404 모델 오류: 프로그램에 입력된 AI 모델 이름이 잘못됐거나 더 이상 지원되지 않을 수 있습니다. 사용 가능한 모델 목록을 확인하고 프로그램 설정을 수정하세요.

503 서비스 오류: 구글 서버가 일시적으로 과부하 상태일 수 있습니다. 잠시 후 다시 시도하거나 사용 가능한 다른 모델로 변경해 볼 수 있습니다.

또 한 가지 확인할 것은 API 키의 유형입니다. 구글은 2026년 5월 28일부터 AI Studio에서 새로 생성되는 키에 새로운 인증 키 방식을 적용하고 있습니다. 예전에 발급받은 표준 키가 작동하지 않는다면 키 유형과 제한 설정을 확인하고, 필요한 경우 새 인증 키로 교체하세요.

8. API 키가 유출됐다면 바로 교체하기

API 키는 비밀번호처럼 관리해야 합니다. 다른 사람이 키를 확보하면 연결된 프로젝트를 통해 API 요청을 시도할 수 있고, 유료 프로젝트에서는 예상하지 못한 비용 문제가 발생할 수도 있습니다.

키를 실수로 공개했다면 AI Studio의 API Keys 메뉴에서 기존 키를 삭제하거나 사용 중지하고 새 키를 발급받으세요. 이후 해당 키를 사용하던 프로그램의 설정을 새 키로 변경해야 합니다. 이미 사용량이 발생했는지도 Usage와 Billing 화면에서 확인하는 것이 좋습니다.

9. 처음 발급받는다면 이것부터 확인하세요

처음 API 키를 사용하는 경우에는 세 가지를 확인하면 됩니다. 첫째, API 키가 어떤 프로젝트에 연결되어 있는지 살펴봅니다. 둘째, 무료로 사용할 계획이라면 프로젝트의 Billing Tier와 모델별 무료 지원 여부를 확인합니다. 셋째, 발급받은 키를 공개 코드나 신뢰할 수 없는 웹사이트에 입력하지 않습니다.

Gemini API 키는 한 번 발급받으면 다양한 개발·자동화 작업에 연결할 수 있지만, 실제로 사용할 수 있는 기능과 비용은 모델 및 프로젝트 설정에 따라 달라집니다. 우선 무료 사용이 가능한 모델로 작은 작업부터 테스트하고, 사용량을 확인한 다음 활용 범위를 넓히는 편이 좋습니다.