제미나이 API 키 발급방법 — 카드 없이 3분, 무료 한도는 공개되지 않습니다

한 줄 요약

aistudio.google.com/apikey ↗ 에 구글 계정으로 들어가 약관에 동의하면 끝입니다. 구글 클라우드 프로젝트와 API 키가 함께 자동으로 만들어집니다. 결제수단을 묻지 않습니다. 걸리는 시간은 3분이 안 됩니다.

그래서 "발급 방법"만 찾고 계셨다면 이 문단에서 끝나도 됩니다. 이 글의 나머지는 발급 뒤에 사람들이 실제로 부딪히는 세 가지입니다 — 이번 달부터 바뀐 키 정책, 아무도 정확히 못 쓰는 무료 한도, 그리고 한국 사용자에게만 해당하는 데이터 문제입니다.

발급 절차

갈림길이 하나 있습니다. 구글 클라우드를 한 번도 안 써본 계정이냐, 써본 계정이냐로 절차가 달라집니다. 대부분의 안내 글이 앞쪽만 설명해서, 뒤쪽에 해당하는 사람이 중간에 막힙니다.

① 구글 클라우드를 처음 쓰는 계정

공식 문서의 표현은 이렇습니다 — 신규 사용자라면 약관에 동의한 뒤 AI Studio가 기본 클라우드 프로젝트와 API 키를 자동으로 만들어 준다는 것입니다. 따로 "프로젝트 만들기"를 찾아 헤맬 필요가 없습니다.

② 구글 클라우드를 써본 적 있는 계정

여기서는 자동 생성이 되지 않습니다. 공식 문서가 명시합니다 — 이미 구글 클라우드 계정이 있으면 AI Studio는 기본 프로젝트를 만들지 않고, 기존 프로젝트를 직접 가져와야(import) 합니다. 그런데 AI Studio는 기본적으로 내 클라우드 프로젝트를 전부 보여주지 않기 때문에, "프로젝트 선택" 목록이 비어 보이는 상황이 생깁니다. 순서는 이렇습니다.

가져온 뒤에도 목록에 키가 안 보일 수 있습니다. AI Studio는 제한이 없거나 제미나이 API로만 제한된 키만 보여줍니다. 다른 구글 API용으로 제한해 둔 키는 아예 표시되지 않습니다.

★ 2026년 9월, 예전에 받아둔 키가 막힙니다

이게 이 글에서 가장 시급한 부분입니다. 제미나이 API 키에는 두 종류가 있습니다.

공식 문서의 문장은 이렇습니다 — 2026년 9월에 제미나이 API가 표준 키의 요청을 거부하며, 그전에 승인 키로 옮겨야 서비스 중단을 피할 수 있다는 것입니다. 제한이 걸려 있지 않은 표준 키는 이미 거부되고 있습니다. 2026년 5월 7일부터는 오랫동안 쓰지 않은 제한 없는 키도 차단되며, AI Studio에 Blocked 태그가 붙습니다.

지금 새로 만드는 키는 신경 쓸 것이 없습니다. AI Studio에서 만드는 모든 새 키는 자동으로 승인 키입니다. 문제는 작년이나 올해 초에 받아서 어딘가에 넣어둔 키입니다. 확인하는 법은 이렇습니다.

순서가 중요합니다. 공식 문서도 새 키가 완전히 활성화되기 전에 옛 키를 지우지 말라고 못을 박습니다. 먼저 지우면 그 사이에 서비스가 멈춥니다.

다만 정확히 9월 며칠인지는 구글이 밝히지 않았습니다. 문서에 "September 2026"까지만 적혀 있습니다. 이 글을 쓰는 9월 12일 기준으로 이미 적용됐을 수도 있고 이달 안에 적용될 수도 있습니다. 미루지 않는 편이 낫습니다.

★ 무료 한도 — 숫자가 적혀 있는 글은 지금 전부 틀렸습니다

"제미나이 API 무료 한도"로 검색하면 분당 15회, 하루 1,500회 같은 숫자가 잔뜩 나옵니다. 지금 그 숫자의 근거가 공식 문서에 없습니다. 구글이 모델별 무료 등급 한도 표를 문서에서 삭제했습니다.

2026년 9월 2일 자로 갱신된 공식 rate limits 페이지에 남아 있는 것은 개념 설명과 유료 티어 표뿐이고, 무료 등급의 분당 요청수·일일 요청수 표는 존재하지 않습니다. 대신 이렇게 안내합니다 — 한도는 사용 등급 등 여러 요인에 따라 달라지며 Google AI Studio에서 확인하라는 것입니다. 게다가 한 줄을 더 붙여 뒀습니다. "명시된 한도는 보장되지 않으며 실제 용량은 달라질 수 있습니다."

숫자 없이도 확인되는 규칙은 있습니다. 이쪽이 오히려 실무에 더 중요합니다.

• 한도는 키가 아니라 프로젝트 단위입니다. 키를 열 개 만들어도 같은 프로젝트면 총량은 그대로입니다. 한국어 안내 글에서 가장 자주 틀리는 부분입니다.
• 측정 축이 세 개입니다 — 분당 요청수(RPM), 분당 입력 토큰수(TPM), 일일 요청수(RPD). 셋 중 하나만 넘어도 한도 오류가 납니다.
• 일일 한도는 태평양시 자정에 초기화됩니다. 한국시간으로는 오후 4시 또는 5시입니다(서머타임에 따라 다름). 문서는 태평양시로만 적습니다.
• 실험·프리뷰 모델은 한도가 더 빡빡합니다. 이미지 모델은 분당 이미지 수(IPM)라는 별도 축을 씁니다.

어떤 모델이 무료인지는 가격 페이지에서 확인됩니다. 2026년 9월 11일 갱신 기준입니다.

★ 무료로 쓰면 입력한 내용이 학습에 들어갑니다 (한국은 예외가 아닙니다)

이 항목이 이 글에서 가장 중요합니다. 한국어 자료에 거의 안 나오는데, 업무 문서나 고객 데이터를 API에 넣을 생각이라면 발급보다 먼저 알아야 할 내용입니다.

구글의 서비스 약관(2026년 3월 23일 발효)은 무료 서비스와 유료 서비스를 나눠서 이렇게 적습니다.

약관 원문은 더 직설적입니다 — 품질 개선을 위해 사람 검토자가 API 입력과 출력을 읽고 주석을 달 수 있으며, 구글은 검토자가 보기 전에 그 데이터를 계정·API 키·클라우드 프로젝트에서 분리한다고 적습니다. 그리고 한 문장을 덧붙입니다. "무료 서비스에 민감하거나 기밀이거나 개인적인 정보를 제출하지 마십시오."

빠져나갈 길은 있고, 생각보다 쌉니다. 약관은 "유료"를 요금이 아니라 결제 계정 연결 여부로 정의합니다 — 활성 결제 계정이 연결된 클라우드 프로젝트로 API를 호출하면 유료 서비스로 취급됩니다. 최소 충전액이 5달러이니, 실제 사용료가 0원에 가깝더라도 5달러를 넣어두면 데이터 취급이 달라집니다. 업무용으로 쓸 계획이면 이 5달러가 가장 값싼 안전장치입니다.

유료 전환 — 5달러 선불부터

무료에서 올라가는 것은 결제 계정을 연결하고 최소 5달러(또는 상당액)를 미리 충전하는 일입니다. AI Studio의 API keys 또는 Projects 페이지에서 Set up billing 을 누르는 데서 시작합니다.

무료에서 Tier 1로는 즉시, 그 위로는 10분 이내에 반영됩니다. 조건을 채워도 심사 과정에서 거절될 수 있다는 단서가 붙어 있습니다.

2026년 3월 23일부터 선불(Prepay)과 후불(Postpay)로 나뉘었고 신규 사용자는 선불이 기본값입니다. 선불에서 조심할 것이 세 가지입니다.

• 미사용 크레딧은 12개월 뒤 소멸하고 환불되지 않습니다. 넉넉히 충전해 둘 이유가 없습니다.
• 잔액이 0이 되면 그 결제 계정에 연결된 모든 프로젝트의 모든 키가 동시에 멈춥니다. 키 하나만 죽는 게 아닙니다.
• 청구 반영에 약 10분이 걸려서, 그사이 잔액을 넘겨 쓰는 일이 생길 수 있다고 문서가 인정합니다.

자동 충전과 월간 자동충전 상한을 걸 수 있고, 프로젝트별 월 지출 상한도 따로 설정할 수 있습니다. 개인 실험용이라면 5달러만 넣고 자동 충전을 꺼두는 것이 가장 안전합니다.

첫 호출 — 패키지 이름이 바뀌었습니다

검색해서 나오는 예제 상당수가 google-generativeai 를 설치하라고 합니다. 지금은 google-genai 입니다. 옛 패키지는 2025년 11월 30일부로 지원이 중단됐고, Live API나 Veo 같은 최신 기능에 접근할 수 없습니다.

환경변수 GEMINI_API_KEY 에 키를 넣어두면 클라이언트가 알아서 읽습니다. 윈도우에서는 검색창에 "환경 변수"를 치고 시스템 속성 → 환경 변수 → 새로 만들기 순서로 넣은 뒤, 터미널을 새로 열어야 반영됩니다. 열려 있던 창에서는 안 잡힙니다.

현재 공식 빠른 시작은 generate_content 가 아니라 Interactions API 를 씁니다. 가장 짧은 파이썬 예제는 이렇습니다.

curl로 확인할 때 인증 헤더는 Bearer 가 아니라 x-goog-api-key 입니다. 엔드포인트는 generativelanguage.googleapis.com/v1beta/interactions 입니다. generate_content 방식도 아직 살아 있지만, 새로 쓰신다면 공식 빠른 시작을 따라가는 편이 낫습니다.

막히면 여기부터 봅니다

재시도는 일시적 오류에만 겁니다. 429·408·5xx는 1초 → 2초 → 4초 → 8초로 늘려가며 재시도하되 무작위 지연을 섞고, 400·403은 재시도하지 않습니다 — 키가 틀렸거나 문법이 틀린 것이라 몇 번을 보내도 같습니다. 파이썬 SDK는 일시적 오류를 기본 4회 자동 재시도합니다.

참고로 Colab에서는 지역 판정이 내 위치가 아니라 인스턴스 위치 기준입니다. 한국에서 접속해도 인스턴스가 미지원 지역이면 막힙니다. !curl ipinfo.io 로 확인하세요.

키 관리 — 비밀번호와 같게 다룹니다

공식 문서의 첫 문장이 "제미나이 API 키를 비밀번호처럼 다루라" 입니다. 유출되면 남이 내 할당량을 쓰고, 예상치 못한 요금이 청구되고, 비공개 리소스에 접근합니다.

• 깃 저장소에 절대 넣지 않습니다. 공개 저장소에 올라간 키는 자동으로 수집됩니다.
• 웹·모바일 앱에 키를 박지 않습니다. 클라이언트 코드에 컴파일된 키는 추출됩니다. 공식 권장은 백엔드 프록시 서버를 두고 거기서 호출하는 것입니다.
• 설정 파일이 아니라 환경변수에서 읽습니다. 운영 환경은 시크릿 관리 서비스를 씁니다.
• 클라우드 콘솔에서 결제 알림을 걸어둡니다.
• AI Studio의 API Keys 페이지에서 Unrestricted 라벨에 마우스를 올려 Add restrictions → Restrict to Gemini API only 로 키를 제한합니다.

유출됐을 때는 순서가 중요합니다. 새 키 생성 → 배포 교체 → 그다음에 옛 키 삭제 → 청구 로그와 사용량 감사. 옛 키를 먼저 지우면 서비스가 멈춥니다.

Vertex AI는 언제 쓰나

구글은 제미나이를 두 갈래로 팝니다. AI Studio 키로 쓰는 Gemini Developer API와, 기업용인 Gemini Enterprise Agent Platform(예전 이름 Vertex AI)입니다. 공식 문서의 판단 기준은 명확합니다 — 특정한 기업용 통제가 필요한 게 아니라면 대부분의 개발자는 Developer API를 쓰라는 것입니다.

서비스 계정 기반 인증, 리전 고정, 조직 단위 IAM, 컴플라이언스가 필요할 때만 넘어갑니다. SDK는 같고 클라이언트 초기화 한 줄만 다릅니다. 다만 가격표가 서로 다르고, AI Studio에서 튜닝한 모델은 다시 학습시켜야 합니다.

이 글을 쓰면서

"제미나이 API 발급"은 단계가 단순해서 글로 쓸 게 없는 주제입니다. 실제로 공식 문서를 열어보니 신규 계정은 약관 동의 한 번에 키까지 나옵니다. 그래서 발급 절차만으로는 어느 글이나 똑같아집니다.

차이가 나는 곳은 그 뒤였습니다. rate limits 문서를 열었더니 다들 인용하는 무료 한도 표가 통째로 없었습니다. 원본 마크다운까지 받아 대조해도 없었고, 대신 "AI Studio에서 확인하라"는 안내와 "명시된 한도는 보장되지 않는다"는 단서만 남아 있었습니다. 지금 한국어 글에 떠도는 숫자는 근거를 잃은 상태입니다.

약관을 읽다가 유럽 예외 조항을 발견한 것이 두 번째였습니다. 무료 등급의 데이터 취급이 지역에 따라 다르고, 한국이 보호받는 쪽에 없다는 사실은 업무에 쓸 사람에게 발급 절차보다 훨씬 중요한 정보라고 봤습니다. 그래서 이 글은 발급 방법을 세 문단에 끝내고 나머지를 여기에 썼습니다.

요금 구조가 궁금하시면 제미나이 요금제 총정리를, API 말고 일반 사용이 목적이면 제미나이 사용법을 보시면 됩니다.