Gemini API 키 발급 방법: AI Studio 무료 키와 제한 설정

Gemini API 키는 Google AI Studio의 API 키 화면에서 무료로 만든다. 로그인한 뒤 Create API key로 만들며 무료 등급은 카드 등록이 필요 없다. 현재 거부되는 것은 제한 없는 standard 키다. 제한을 설정한 standard 키는 계속 쓸 수 있으므로, 생성일만으로 교체 여부를 정하지 않는다.

키 만드는 순서

메뉴 이름은 9월 29일 공식 API 키 안내의 영문 표기를 기준으로 적었다.

1. aistudio.google.com/apikey에 Google 계정으로 로그인하고 약관에 동의한다. 처음 쓰는 계정은 기본 Google Cloud 프로젝트와 키가 자동으로 만들어지기도 한다. 이미 있다면 새로 만들지 않고 그 키를 써도 된다.
2. Create API key를 누른다.
3. 키를 넣을 프로젝트를 고른다. 쓰던 Google Cloud 프로젝트가 목록에 없으면 Dashboard → Projects → Import projects로 먼저 불러온다.
4. 만들어진 키를 복사해 안전한 곳에 둔다. 키 값은 공개 문서나 저장소에 붙여 넣지 않는다.
5. 목록의 결제 등급이 무료 등급인지 본다. 유료 등급 프로젝트의 키로 호출하면 요금이 나온다.

AI Studio에서는 프로젝트를 한 번에 최대 10개까지 만들 수 있다. 목록에 키 100개·프로젝트 50개까지 보이는 것은 화면 표시 한도다. (API 키 관리)

예전 키 교체

구분	예전 키(standard)	새 키(authorization)
AI Studio 생성 기준	2026년 5월 28일 전의 기본 방식	5월 28일부터 AI Studio에서 새로 만드는 키
Gemini API	제한 없는 키는 거부. 명시적으로 제한한 키는 계속 사용 가능	서비스 계정에 연결되며 Gemini API로 기본 제한
유출 대응	일반	유출이 확인된 키를 더 빨리 차단

제한 없는 standard 키를 Gemini API 전용으로 쓴다면 AI Studio에서 Unrestricted → Add restrictions → Restrict to Gemini API only → Restrict key로 제한할 수 있다. 키 수정 권한이 필요하다. authorization 키로 옮기려면 새 키를 만들고 앱·환경 변수에 반영한 뒤 동작을 확인하고 옛 키를 삭제한다. 키 종류는 Key Type 열에서 확인한다. (API 키 관리)

무료 등급과 유료 등급

무료 등급: 카드 없이 쓸 수 있고, 모델마다 한도가 따로 있다. 한도는 AI Studio의 비율 제한 메뉴와 사용 한도 문서에서 본다. 9월 29일 가격표 기준으로 무료 등급에서 쓸 수 있는 주요 모델은 다음과 같다.

무료 등급에서 사용 가능	유료 등급만
Gemini 3.8·3.7·3.6·3.5 Flash	Gemini 3.1 Pro Preview
Gemini 3.5·3.1 Flash-Lite	Gemini 3.1 Flash Image
Gemini 2.5 Pro·Flash·Flash-Lite, Embedding 2	Gemini Omni Flash

유료 등급: 결제 계정을 연결한다. 선불 결제(Prepay)로 설정되는 계정은 최소 5달러 또는 해당 통화 금액을 충전하며, 계정에 따라 후불 결제(Postpay)가 안내될 수 있다. 첫 유료 등급은 결제 계정당 월 지출 상한이 250달러이고, 누적 지출과 기간을 채우면 다음 등급으로 자동으로 오른다. Prepay 잔액이 바닥나면 해당 결제 계정의 모든 프로젝트에서 Gemini API 사용이 중단되고 402 오류가 날 수 있다. 충전액은 1년 뒤 만료되고, Google Cloud 무료 체험 크레딧으로는 낼 수 없다. (결제 안내)

키를 넣고 되는지 확인

첫 확인에서는 키를 명령 문자열에 붙여 넣지 말고 아래 입력창에 가려서 입력합니다. Read-Host -AsSecureString은 입력한 문자 대신 별표를 표시합니다. (Microsoft 입력 안내)

$geminiKey = Read-Host "Gemini API key" -AsSecureString
$env:GEMINI_API_KEY = [System.Net.NetworkCredential]::new("", $geminiKey).Password
Remove-Variable geminiKey
if ($env:GEMINI_API_KEY) { "키 입력 완료" }

다음 요청도 같은 PowerShell 창에서 실행합니다. 새 창에서는 다시 입력해야 합니다. 환경 변수에는 평문 값이 들어가므로 키 값을 출력하거나 화면에 공유하지 마세요.

같은 창에서 다음 명령으로 짧은 요청을 보낸다. 응답이 출력되면 키가 정상이다. (빠른 시작)

$body = '{"model":"gemini-3.8-flash","input":"한 문장으로 인사해줘"}'
Invoke-RestMethod -Method Post -Uri "https://generativelanguage.googleapis.com/v1beta/interactions" -Headers @{ "x-goog-api-key" = $env:GEMINI_API_KEY } -ContentType "application/json; charset=utf-8" -Body $body

한글 요청의 인코딩을 지정하도록 ContentType에 charset=utf-8을 포함했다.

실습을 마치면 Remove-Item Env:GEMINI_API_KEY로 현재 창의 값을 지웁니다. 발급한 키 자체는 남으므로 노출됐다면 AI Studio에서 폐기하고 새로 만드세요. Python으로 이어서 호출하려면 Gemini API 사용법을 참고합니다.

오류별 해결

오류 숫자와 응답의 code·message를 함께 본다. 아래는 공식 Interactions 오류표와 API 키 관리 안내에 따른 확인 순서다. (오류 문서)

오류	원인	조치
401 authentication	키 누락·잘못된 값·만료	키 전달 여부, 키 종류와 제한 상태를 확인한다
403 permission_denied	리소스에 대한 권한 부족	API 키 권한과 프로젝트 접근 권한을 확인한다
“reported as leaked”	키가 공개 저장소 등에 노출됨	옛 키를 지우고 새 키를 만든다
429	분당·일일 한도 초과	분당 한도는 잠시 뒤 다시 보낸다. 일일 한도는 한국 시각 오후 4시(서머타임이 아닐 때 5시)에 초기화된다
400 failed_precondition	결제 설정 등 조건 미충족	프로젝트의 결제 등급과 결제 계정을 본다
402	선불 잔액 소진	결제 계정에 충전한다

키를 .env 파일에 둔다면 .gitignore에 넣고, 웹·모바일 앱 코드에는 넣지 않는다. 앱을 받은 사람이 키를 꺼낼 수 있다. Google Cloud 콘솔에서 키를 쓸 수 있는 IP나 앱을 제한할 수 있다.

자주 묻는 질문

키 발급에 돈이 드나? 아니다. 무료 등급 모델을 한도 안에서 쓰면 요금이 없다. 결제 계정을 연결한 뒤부터 사용량만큼 나간다.

키를 여러 개 만들어도 되나? 된다. 용도별로 나누면 유출된 키만 지우면 된다. 같은 프로젝트의 키는 한도를 함께 쓴다.

한국에서 쓸 수 있나? 한국은 지원 지역이다. 만 18세 이상이어야 한다.

첫 프로그램은 Gemini API 사용법에서, 모델 가격은 Gemini 3.8 Flash 정리에서 이어서 본다.