번그림

Gemini API 키 발급 안내

Google AI Studio 에서 내 키를 만드는 방법이에요. 화면을 따라 누르기만 하면 되고, 5분 정도 걸려요. 아래 화면 그림은 한국어판 기준입니다.

시작 전 준비물

먼저 알아 둘 것
  1. AI Studio 키 화면 열기

    브라우저 주소 칸에 아래 주소를 적거나 눌러서 열어요.

    https://aistudio.google.com/apikey

    Google 에 로그인하지 않았다면 로그인 화면이 먼저 나와요. 계정을 고르고 [다음]을 눌러 로그인하세요. 처음 쓰는 계정이면 약관에 동의하는 화면이 나올 수 있으니 내용을 읽고 진행하세요.

    공식 문서에 따르면 새 사용자는 약관에 동의한 뒤 AI Studio 가 기본 프로젝트와 API 키를 자동으로 하나 만들어 둬요. 목록에 이미 키가 있다면 그 키를 써도 되고, 아래 2단계부터 새로 만들어도 됩니다.

    브라우저 주소 칸에 aistudio.google.com/apikey 가 적혀 있고, 아래에 Google 계정으로 로그인하는 상자와 다음 단추가 있는 그림
    실제 화면을 단순화한 그림이에요. 로그인 화면의 모양은 계정 상태에 따라 달라요.
  2. [API 키 만들기] 누르기

    로그인하면 API 키 목록 화면이 나와요. 화면 오른쪽 위에서 이름이 API 키 만들기인 단추를 찾아 누르세요. 아래 그림에서 빨간 상자가 그 단추예요.

    API 키 목록 화면. 오른쪽 위의 API 키 만들기 단추에 빨간 상자가 쳐져 있고, 아래에 키, 프로젝트, 생성일, 결제 등급 칸이 있는 목록이 보인다. 개인정보는 가려져 있다.
    실제 화면이에요(개인정보는 가렸어요). 폰에서는 글자가 작게 보여요. 그림을 누르면 원래 크기로 열려요.

    화면 크기에 따라 단추 위치가 조금 다를 수 있어요. 그럴 땐 이름이 같은 단추를 찾으세요. 목록 왼쪽 메뉴에는 'API 키 · 프로젝트 · 사용량 · 비율 제한 · 지출 · 결제'가 있어요.

  3. 이름 적고 프로젝트 고르기

    새 키 만들기 창이 열려요. 칸이 둘 있어요.

    • 키 이름 지정 — 알아보기 쉬운 이름을 적어요. 처음에는 'Gemini API Key'가 미리 적혀 있어요. 그대로 둬도 돼요.
    • 가져온 프로젝트 선택 — 처음이면 'Default Gemini Project'가 골라져 있어요. 그대로 두면 돼요.

    준비가 됐으면 오른쪽 아래 [키 만들기]를 누르세요. 그만두려면 [취소]예요.

    새 키 만들기 창. 키 이름 지정 칸에 Gemini API Key, 가져온 프로젝트 선택 칸에 Default Gemini Project 가 들어 있고, 오른쪽 아래의 키 만들기 단추에 빨간 상자가 쳐져 있다.
    실제 화면이에요.

    프로젝트가 아직 없다면

    '가져온 프로젝트 선택' 칸을 누르면 목록이 펼쳐져요. 거기에서 + 프로젝트 만들기를 눌러 새 프로젝트를 만들 수 있어요. 목록에는 '프로젝트 가져오기'도 있는데, 이미 Google Cloud 를 쓰던 분이 기존 프로젝트를 불러오는 용도예요. 처음이라면 쓰지 않아도 돼요.

    프로젝트 선택 칸이 펼쳐진 모습. 프로젝트 가져오기와 프로젝트 만들기 항목이 보이고, 프로젝트 만들기에 빨간 상자가 쳐져 있다.
    실제 화면이에요.
    '권한이 없다'는 말이 나오면

    공식 문서에 따르면 회사나 학교 계정처럼 관리자가 있는 프로젝트에서는 키를 만들 권한이 없다는 말이 나올 수 있어요. 이때는 관리자에게 권한을 달라고 하거나, 조직에 속하지 않는 새 프로젝트를 만들어 쓰면 된다고 해요. 개인 Google 계정이면 보통 상관없어요.

  4. 키 복사하기

    키가 만들어지면 목록에 새 줄이 생겨요. 그 줄의 오른쪽 끝에 있는 아이콘 가운데 복사 아이콘을 눌러 키를 복사하세요. 줄 오른쪽에는 아이콘이 여러 개(복사, 결제, 사용량, 데이터, 점 세 개 메뉴)가 있어요.

    정확한 모양은 화면마다 다를 수 있어요. 키를 열어 보는 칸이 따로 나오면 거기서 복사해도 같아요. 키는 보통 영어와 숫자가 섞인 긴 글자 한 줄이에요.

    키 목록의 한 줄. 키 이름 Gemini API Key, 가려진 키 값 예시, 프로젝트 이름과 무료 등급이 보이고, 줄 오른쪽 끝의 복사 아이콘에 빨간 상자가 쳐져 있다.
    실제 화면을 단순화한 그림이에요. 키 값 예시는 일부러 가렸어요.
    복사한 키는 아무 데나 붙여 넣지 마세요

    다른 사람이 볼 수 있는 곳에 키를 붙이면 그 사람이 내 키로 요청을 보낼 수 있어요. 번그림 도구의 키 칸에만 붙여 넣으세요.

  5. 번그림 도구에 붙여 넣기

    도구가 열리면 키를 넣는 칸이 맨 위에 나와요. 복사한 키를 붙여 넣으세요(컴퓨터는 Ctrl+V, 폰은 칸을 길게 눌러 '붙여넣기').

    그 전에 주소 칸을 먼저 확인하세요. 번그림 도구의 진짜 주소는 아래 하나뿐이에요. 비슷하게 생긴 다른 주소에는 키를 넣지 마세요.

    https://beongeurim-tool.pages.dev

    • '이 기기에 기억'은 기본으로 꺼져 있어요. 꺼 두면 탭을 닫을 때 키가 사라져요.
    • 내 컴퓨터나 폰에서만 쓴다면 켜도 돼요. 학교, PC방, 빌린 기기라면 켜지 마세요.
    번그림 도구 화면 예정 모양. 주소 칸에 beongeurim-tool.pages.dev 가 있고, 아래의 키 칸에 가려진 키가 들어 있으며, 이 기기에 기억 상자는 꺼져 있다.
    도구는 아직 만드는 중이라 예정 모양을 단순화한 그림이에요. 실제 화면은 달라질 수 있어요.

    도구가 열리지 않았어도 키는 미리 만들어 둘 수 있어요.

키 지키기 · 지우기

공식 문서는 Gemini API 키를 비밀번호처럼 다루라고 해요. 새어 나가면 다른 사람이 내 프로젝트의 사용량을 쓰거나 뜻밖의 요금이 생길 수 있고요.

키를 지우려면

AI Studio 의 API 키 목록으로 돌아가 그 키 줄 오른쪽 끝의 점 세 개(⋮) 메뉴를 열어 삭제를 고르면 돼요. 메뉴 글자는 화면마다 조금 다를 수 있어요. 다 쓰고 나서나 쓰지 않을 때는 지워 두는 것이 안전해요.

키가 새어 나간 것 같다면

공식 문서의 순서는 이래요.

  1. 새 키를 만든다.
  2. 쓰던 곳의 키를 새 키로 바꾼다.
  3. 새 키가 잘 되는 것을 확인하고 나서 이전 키를 끄거나 지운다.
  4. 사용량을 살펴 내가 하지 않은 사용이 있는지 본다.

자주 묻는 것

결제 설정을 안 해도 되나요?

네, 안 해도 돼요. 공식 문서에 따르면 새 계정은 무료 등급에서 시작하고, 무료 등급은 일부 모델을 정해진 한도 안에서 쓸 수 있어요. 키 목록의 '결제 등급' 칸에 무료 등급이라고 보이면 무료 키예요.

같은 칸의 결제 설정 링크를 눌러 결제 계정을 연결하면 유료 등급으로 올라갈 수 있어요. 무료로만 쓰고 싶다면 누르지 마세요. 우리가 본 키 만들기 창에는 결제 정보를 묻는 칸이 없었어요.

'하루 한도'가 뭔가요?

무료 키로 하루에 보낼 수 있는 요청 횟수예요. 공식 문서는 한도를 분당 요청 수, 분당 글자(토큰) 수, 하루 요청 수 세 가지로 재고, 하나라도 넘으면 오류가 난다고 설명해요.

  • 한도는 키가 아니라 프로젝트 단위예요. 같은 프로젝트에서 키를 여러 개 만들어도 한도는 합쳐서 세요.
  • 하루 한도는 미국 태평양 시간 자정에 새로 시작해요. 한국 시간으로는 오후 4시 무렵(미국 서머타임일 때)이나 오후 5시 무렵(아닐 때)이에요. 이 한국 시간은 우리가 계산한 값이에요.
  • 모델마다 한도가 달라요. 번그림 팀이 확인한 모델에서는 하루 약 20번이었지만 바뀔 수 있어요. 내 키의 정확한 숫자는 왼쪽 메뉴의 비율 제한 화면에서 볼 수 있어요.

그림 한 장을 번역하는 데 요청이 한 번 이상 들어가요. 그래서 하루에 번역할 수 있는 장 수는 20장보다 적을 수 있어요.

429 오류가 나요

429 는 '요청이 너무 많다'는 뜻으로, 한도를 넘었다는 신호예요. 공식 문서도 한도를 넘으면 429 오류가 난다고 해요. 이럴 땐 잠시 기다렸다가 다시 시도하거나, 하루 한도가 다 찼다면 한도가 새로 시작하는 시간(위 설명)을 기다리세요. 번그림 도구는 429 가 나면 다른 모델로 넘겨 보도록 만들고 있어요.

비슷하게 503 은 Google 쪽이 바쁘다는 뜻이에요. 조금 뒤에 다시 해 보세요.

예전에 만든 키가 안 돼요

공식 문서에 따르면 2026년 5월 28일부터 AI Studio 에서 새로 만드는 키는 자동으로 '인증 키(auth key)'가 되어요. 또 제한이 없는 예전 방식 키는 Gemini API 가 받아 주지 않고, 오래 쓰지 않은 제한 없는 키는 막혀서(Blocked) 표시돼요. 이런 키는 고치기보다 새 키를 만드는 것이 가장 빨라요.

키를 잃어버렸어요

AI Studio 의 API 키 목록에서 키를 다시 볼 수 있는지는 화면마다 다를 수 있어요. 찾지 못하면 위 2~4단계로 새 키를 만들고, 잃어버린 키는 목록에서 지워 두세요. 새로 만들어도 하루 한도는 같은 프로젝트라면 이어져요.

공식 문서는 "웹앱에 키를 넣지 말라"는데요?

공식 문서의 그 경고는 개발자가 자기 키를 웹앱 코드에 박아 넣어 모든 방문자가 그 키를 쓰게 되는 경우를 말해요. 번그림은 그렇게 하지 않아요. 번그림에는 키가 하나도 들어 있지 않고, 각자 자기 키를 자기 브라우저에서 써요. 그래도 키가 내 브라우저에 있다는 점은 같으니, 도구 주소를 확인하고 공용 기기에서는 기억 기능을 꺼 두세요.

유럽이나 영국에 살아요

Gemini API 약관은 유럽경제지역(EEA) · 영국 · 스위스 사용자에게 내놓는 서비스에는 유료 서비스만 쓰라고 해요. 그래서 이 지역에서는 유료 키가 필요하다고 안내해요. 법적인 판단은 아니에요. 약관은 Google 에서 직접 확인하세요.

참고한 공식 문서

화면과 정책은 Google 이 바꿀 수 있어요. 이 안내와 다르면 공식 문서가 맞아요.

키를 만들었다면

번그림 도구가 열리면 위 5단계대로 붙여 넣으면 돼요. 도구는 지금 만드는 중이에요.

번그림 소개로 돌아가기