구글 AI 스튜디오 API 키 받는 법을 검색하는 사람 대부분이 막히는 지점은 회원가입이 아니라 “어디서 키를 발급하냐”는 것이다. 구글 계정만 있으면 끝나는 일인데, 처음 보는 UI 때문에 10분 넘게 헤매는 경우가 많다. 직접 발급해보고 실제 쓰기까지 해봤으니 그 과정을 있는 그대로 쓴다.
Google AI 스튜디오가 뭔지 먼저 한 줄로
Google AI 스튜디오(aistudio.google.com)는 구글이 만든 Gemini 모델을 브라우저에서 바로 테스트하고, API 키를 발급받을 수 있는 공식 웹 인터페이스다. 유료 결제 없이 무료 티어로 시작할 수 있고, 발급받은 API 키는 파이썬·자바스크립트·앱스스크립트 등 어디서든 붙여 쓸 수 있다. 2024년 기준 무료 티어는 분당 요청 15회, 하루 1,500회 제한이 붙어 있다. 개인 프로젝트 수준에서는 이 제한에 거의 걸리지 않는다.
중요한 건 AI 스튜디오 자체가 Gemini API의 관문이라는 점이다. ChatGPT의 OpenAI 플랫폼과 역할이 같다고 보면 된다. 이 사이트에서 키를 만들고, 그 키를 코드에 넣으면 Gemini 모델을 외부 앱에서 호출할 수 있다.
API 키 발급 전에 반드시 확인할 것 두 가지
첫째, 구글 계정이 만 18세 이상이어야 한다. 연령 제한에 걸리면 AI 스튜디오 자체가 열리지 않는다. 군 생활 중이라면 입대 전에 만든 계정을 그대로 쓰면 되고, 대부분 문제없다.
둘째, 구글 계정이 Workspace(학교·회사 계정)일 경우 조직 관리자가 AI 스튜디오 접근을 막아뒀을 수 있다. 이 경우 개인 Gmail 계정(@gmail.com)으로 로그인하는 게 가장 빠른 해결책이다. Workspace 계정 권한 해제를 요청하는 것보다 시간이 훨씬 덜 걸린다.
이 두 가지만 확인했으면 실제 발급 단계로 넘어간다.
구글 AI 스튜디오 API 키 받는 법 — 단계별 순서
아래는 내가 직접 따라간 순서다. 클릭 횟수로 따지면 총 6번이면 키가 생성된다.
- 1단계. 브라우저에서 aistudio.google.com 으로 접속한다. 구글 계정으로 로그인하지 않았으면 자동으로 로그인 화면으로 넘어간다.
- 2단계. 로그인 후 좌측 사이드바 하단에 있는 “Get API key” 버튼을 클릭한다. 영문 UI 기준이며, 한국어로 전환해도 동일한 위치에 있다.
- 3단계. “API keys” 페이지로 이동하면 “Create API key” 버튼이 상단에 보인다. 클릭한다.
- 4단계. 팝업창이 뜨면서 “Create API key in new project”와 기존 프로젝트 선택 두 가지 옵션이 나온다. 처음 발급이라면 “Create API key in new project”를 선택하면 된다. 구글 클라우드 프로젝트가 자동으로 생성되면서 키가 묶인다.
- 5단계. 수 초 내로 키 문자열이 화면에 표시된다. 형식은
AIzaSy...로 시작하는 39자리 문자열이다. - 6단계. “Copy” 버튼을 눌러 복사한다. 이 창을 닫으면 키 전체를 다시 볼 수 없고, 목록에서 키 일부만 마스킹된 상태로 보인다. 복사 후 텍스트 파일이나 비밀번호 관리 앱에 즉시 보관한다.
발급 자체는 여기서 끝이다. 별도 신청서나 승인 대기 없이 즉시 사용 가능한 상태가 된다.
키를 발급받은 뒤 보안에서 놓치기 쉬운 부분
API 키는 한 번 노출되면 타인이 내 할당량을 전부 써버릴 수 있다. 특히 코드를 깃허브에 올릴 때 키 문자열을 그대로 하드코딩해서 push하는 실수가 잦다. 내가 처음에 테스트 코드 짤 때도 비슷하게 할 뻔했다.
관리 방법은 간단하다.
- 파이썬 프로젝트라면 키를
.env파일에GEMINI_API_KEY=AIzaSy...형태로 저장하고,.gitignore에.env를 추가한다. - 구글 앱스스크립트에서 쓸 때는 스크립트 속성(Script Properties)에 키를 저장하고 코드에서
PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY')로 불러온다. - 키가 노출됐다고 의심되면 AI 스튜디오 “API keys” 페이지에서 해당 키 옆 휴지통 아이콘으로 즉시 삭제하고 새로 발급하면 된다. 삭제는 즉시 반영된다.
무료 티어 사용자는 결제 정보를 등록하지 않았으므로 키가 노출돼도 금전 피해는 없지만, 할당량을 소진당해 본인 프로젝트가 멈추는 상황은 생긴다. 습관적으로 키를 환경 변수로 분리해두는 게 낫다.
무료 티어 한도와 유료 전환 시점 판단
구글 AI 스튜디오의 무료 티어(Free tier)는 Gemini 1.5 Flash 기준 분당 15회 요청, 하루 1,500회 요청, 분당 100만 토큰 처리가 가능하다. 텍스트 자동화 프로젝트를 하루에 수십 번 돌리는 수준이라면 무료 티어로 수개월은 버틸 수 있다.
유료 전환이 필요한 시점은 두 가지다.
- 하루 1,500회 한도에 실제로 걸려서 응답이 429 에러(Too Many Requests)로 돌아오기 시작할 때
- Gemini 1.5 Pro 또는 Gemini 2.0 계열 최신 모델을 안정적으로 써야 할 때 (일부 모델은 무료 티어에서 속도·한도 제한이 더 빡빡하다)
유료 전환은 AI 스튜디오에서 직접 하지 않고, 구글 클라우드 콘솔(console.cloud.google.com)에서 결제 계정을 연결한 뒤 Gemini API를 유료로 활성화하는 방식이다. AI 스튜디오에서 발급한 키를 그대로 쓰면서 플랜만 올라가는 구조다.
키 발급 후 동작 확인하는 가장 빠른 방법
키를 받았는데 실제로 작동하는지 확인하고 싶을 때 가장 빠른 방법은 AI 스튜디오 내 Playground를 쓰는 것이다. 발급된 키를 코드에 붙이기 전에, AI 스튜디오 화면 왼쪽 “Stream realtime” 또는 “Text input” 항목에서 바로 프롬프트를 날려볼 수 있다. 응답이 오면 키가 정상 발급된 것이다.
파이썬으로 확인하고 싶다면 아래 구조의 코드 3줄이면 된다. 실제 코드를 그대로 쓰는 건 독자 상황에 따라 다르므로 구조만 설명한다.
google-generativeai패키지를 pip으로 설치한다.- 발급받은 키를 환경 변수에서 불러와
genai.configure(api_key=...)에 넣는다. model.generate_content("Hello")를 실행해서 텍스트 응답이 오면 정상이다.
응답 대신 400 API_KEY_INVALID 에러가 뜨면 키를 복사할 때 앞뒤 공백이 붙었거나, 키 문자열 중간에 줄바꿈이 들어간 경우다. 텍스트 에디터에서 키를 붙여넣어 공백 여부를 눈으로 확인한 뒤 다시 시도하면 대부분 해결된다.
자동화 파이프라인을 좀 더 길게 굴려보고 싶다면 내가 쇼츠 20여 편을 만든 자동화 구조 기록을 참고할 수 있다. 영상 한 편 제작비 약 390원 구조에서 Gemini API가 어떤 위치에 들어가는지 설명해뒀다.
키 하나로 여러 프로젝트를 돌릴 때 주의사항
무료 티어는 계정 단위로 할당량이 묶인다. 즉 키를 3개 발급해도 총 요청 한도는 하루 1,500회로 동일하다. 키를 여러 개 만들어 한도를 우회하는 건 불가능하다는 뜻이다. 프로젝트별로 키를 분리하는 건 보안과 추적 목적으로는 의미가 있지만, 한도 분산 목적으로는 효과가 없다.
반대로 여러 프로젝트에서 키 하나를 공유하는 건 기능상 가능하다. 다만 키가 어디에 쓰이는지 추적이 안 되므로, 나는 용도별로 키를 분리해서 발급하고 키 이름(별칭)을 AI 스튜디오에서 설정해두는 방식을 쓰고 있다. “shorts-automation”, “test-key” 식으로 이름을 붙여두면 나중에 어느 키를 삭제해야 하는지 헷갈리지 않는다.
발급부터 실사용까지, 결국 막히는 건 단계가 아니라 보안 습관이다
구글 AI 스튜디오 API 키 받는 법 자체는 클릭 6번이면 끝난다. 구글 계정 로그인 → AI 스튜디오 접속 → “Get API key” → “Create API key in new project” → 생성 대기 → 복사. 이게 전부다. 막히는 사람 대부분은 발급이 어려운 게 아니라 키를 어디에 보관하고 코드에 어떻게 붙이냐에서 시간을 쓴다. 키를 환경 변수로 분리하고, 깃허브에 올리기 전 .gitignore에 .env를 추가하는 습관 하나만 들여도 나중에 생길 수 있는 문제의 90%는 사전에 막힌다. 무료 티어 한도 안에서 프로젝트를 충분히 테스트한 뒤, 실제로 한도에 걸릴 때 유료 전환을 검토하면 된다. 그 전까지는 돈 한 푼 안 써도 Gemini API를 실무에 붙일 수 있다.