실제 화면 기준 · 2026년 9월

Groq와 Gemini
API 키 받는 법

둘 다 신용카드 없이, 5분이면 끝납니다. 아래 화면들은 오늘 실제 콘솔에서 확인한 것을 그대로 옮긴 것이라 버튼 위치와 문구가 눈앞 화면과 같습니다. 번호 표시(①)가 붙은 곳만 순서대로 누르면 됩니다.

카드 등록 필요 없음 구글 계정이면 둘 다 가입 끝 소요 시간 약 5분

먼저, API 키가 뭔가요

이것만 알고 시작하면 나머지는 다 따라옵니다.

비유

내 계정의 출입증

프로그램이 "이건 재웅님 계정입니다" 하고 내미는 신분증입니다. 사람이 로그인하는 대신, 코드가 이 문자열 하나로 로그인합니다.

생김새

그냥 긴 문자열

Groq은 gsk_로, Gemini는 AIza로 시작하는 40~60자짜리 글자 덩어리입니다. 파일 아니고, 설치할 것도 없습니다.

주의

비밀번호와 같은 급

남이 이 문자열을 알면 내 계정으로 요금을 쓸 수 있습니다. 카톡·슬랙·깃허브에 절대 올리지 않습니다.

중요
키는 발급 직후 딱 한 번만 전체가 보입니다. 창을 닫으면 앞뒤 몇 글자만 남고 다시는 볼 수 없어요. 두 서비스 모두 그렇습니다. 그러니 키가 뜨는 순간 바로 복사해서 메모장에 붙여넣으세요. 놓쳤으면 지우고 새로 만들면 됩니다 — 그게 정상 절차입니다.

Groq 키 받기

console.groq.com

오픈소스 모델을 아주 빠르게 돌려주는 서비스입니다. 무료 등급이 넉넉해서 연습용으로 좋습니다.

1

console.groq.com/keys 로 들어가서 로그인

주소창에 console.groq.com/keys 를 칩니다. 로그인이 안 돼 있으면 바로 이 화면이 뜹니다. 계정이 없어도 괜찮아요 — 아래 버튼은 로그인 겸 회원가입이라 구글 계정만 있으면 클릭 두 번으로 끝납니다.

console.groq.com/keys
PlaygroundAPI KeysDashboardDocs Log In
Create an account or
login to access this page
G Continue with Google 1
Continue with GitHub
Continue with SSO
or
example@email.com
Continue with email
Groq 로그인 화면. 구글 버튼 하나면 가입까지 같이 됩니다.
2

API Keys 화면에서 + Create API Key 클릭

로그인하면 이 목록 화면이 나옵니다. 처음이면 표가 비어 있어요. 오른쪽 위의 주황 테두리 버튼이 키를 새로 만드는 버튼입니다.

console.groq.com/keys
Personal  /  Default Project PlaygroundAPI KeysDashboardDocs F
API Keys
Manage your project API keys. Remember to keep your API keys safe to prevent unauthorized access.
+  Create API Key 2
NameSecret keyCreatedLast usedExpiresUsage (24hrs)
my-first-key gsk_…a4F2 2026. 9. 3. Never Never 0 API Calls ✎🗑
키를 만들고 나면 이렇게 목록에 한 줄이 생깁니다. Secret key 칸은 앞뒤만 보여줍니다.
3

이름을 정하고 Submit

작은 창이 뜹니다. Display Name은 나만 보는 별명이라 아무거나 써도 됩니다 (예: my-first-key). 이름을 한 글자라도 입력해야 Submit 버튼이 나타납니다. Expiration은 키 유효기간인데, 처음이면 기본값 No expiration 그대로 두세요.

console.groq.com/keys
Create API Key×
Display Name
my-first-key
3
A display name for the key. Maximum 50 characters.
Expiration
No expiration ⌄
This key will not expire.
Submit 4
Expiration 선택지는 No expiration / 7일 / 30일 / 60일 / 90일 / Custom 여섯 개입니다.
4

딱 한 번 나오는 키를 지금 복사

Submit을 누르면 gsk_로 시작하는 전체 키가 화면에 뜹니다. 이 창을 닫으면 다시 못 봅니다. Copy를 누르고, 바로 메모장이든 어디든 붙여넣으세요. 아래 보관하기 단계로 바로 이어가면 제일 안전합니다.

console.groq.com/keys
API Key Created×
gsk_9Kx2mPq7vLdT4nRbW8yZaHcE… Copy
5
Please save this secret key somewhere safe and accessible. You won't be able to view it again.
재현 이 화면만 재현입니다. 자동 클릭으로는 키 생성이 차단돼서 직접 캡처를 못 했어요 — 문구는 조금 다를 수 있지만 위치와 흐름은 같습니다.

Gemini 키 받기

aistudio.google.com

구글 AI 스튜디오에서 발급합니다. 구글 계정으로 이미 로그인돼 있으면 클릭 세 번이면 끝납니다.

1

aistudio.google.com/apikey 로 들어가기

주소창에 aistudio.google.com/apikey 를 칩니다. 구글 로그인 상태면 바로 이 화면이 열려요. 화면이 한국어로 나오는 게 정상입니다. 오른쪽 위 파란 버튼 API 키 만들기가 목표입니다.

aistudio.google.com/apikey
Google AI Studio
‹  Dashboard
프로젝트
API 키
프로젝트
사용량 및 결제
사용량
비율 제한
지출
결제
API 키
API 빠른 시작
API 키 만들기 1
그룹화 기준 API 키프로젝트
키프로젝트생성일결제 등급
…aB3x
Gemini API Key
gen-lang-client-0000000000
2026. 9. 3.
무료 등급
발급 후 목록. 결제 등급이 "무료 등급"이면 카드 없이 쓰고 있다는 뜻입니다.
2

작은 창에서 키 만들기 누르기

키 이름 지정과 가져온 프로젝트 선택 두 칸이 이미 채워져 있습니다. 처음이면 둘 다 손대지 말고 그대로 키 만들기를 누르면 됩니다. 프로젝트가 하나도 없으면 Default Gemini Project가 자동으로 만들어집니다.

aistudio.google.com/apikey
새 키 만들기×
키 이름 지정
Gemini API Key
가져온 프로젝트 선택
Default Gemini Project ⌄
취소 키 만들기 2
이름은 나중에 바꿀 수 있으니 고민하지 않아도 됩니다.
3

뜬 키를 바로 복사

AIza로 시작하는 키가 뜹니다. Groq과 똑같이 지금이 전체를 볼 수 있는 유일한 순간이에요. 복사 아이콘을 누르고 곧장 아래 보관하기로 넘어가세요.

aistudio.google.com/apikey
API 키가 생성됨×
AIzaSyD7m2QpXv4RkT… 복사
2
API 키를 안전하게 보관하세요. 다른 사람과 공유하지 마세요.
재현 이 화면도 재현입니다. 자동 클릭이 구글 봇 탐지에 막혀서 직접 캡처를 못 했어요.

받은 키, WMS 어디에 넣나요

파일을 만들 것도, 설치할 것도 없습니다 — 화면에 붙여넣으면 끝입니다.

1

오른쪽 위 톱니(⚙) → 내 API 키

WMS 어느 화면에서든 오른쪽 위 톱니를 누르면 메뉴가 열립니다. 그 안의 내 API 키를 고르면 아래 창이 뜹니다.

wms.breev.kr
내 API 키✕

대부분은 넣지 않아도 됩니다. 로그인하고 현장 권한이 있으면 회사 공용 키로 AI가 돕니다.

GROQ_API_KEY 미등록
gsk_9Kx2mPq7vLdT4nRbW8yZaHcE…
저장 1 2
GEMINI_API_KEY 미등록
AIzaSyD7m2QpXv4RkT…
저장
칸마다 저장을 따로 누릅니다. 하나만 넣어도 됩니다. 저장되면 옆 표시가 미등록에서 등록됨으로 바뀝니다.
2

이름이 같은 칸에 넣습니다

Groq 키는 gsk_, Gemini 키는 AIza로 시작합니다. 서로 바꿔 넣으면 키가 틀렸다는 오류가 납니다. 앞뒤 공백이나 줄바꿈이 같이 붙지 않았는지도 한 번 보세요.

참고
키를 꼭 받아야 하는 것은 아닙니다. 로그인하고 현장 권한이 하나라도 있으면 회사 공용 키로 AI가 그냥 돕니다. 한도 초과가 자주 뜨거나 내 한도로 넉넉히 쓰고 싶을 때만 받으세요. 내 키를 넣으면 공용 키보다 먼저 쓰이고, 지우면 다시 공용 키로 돌아갑니다.
✕

카톡·메일로 전달하기. 대화방은 영구 저장소입니다. 남에게 줘야 하면 그 사람이 자기 키를 따로 발급받게 하세요.

✕

화면 캡처에 담기. 키가 보이는 화면을 캡처해 보고서나 대화방에 올리면 그대로 새어 나갑니다.

✓

실수로 노출했다면 지우고 새로 만들기. 콘솔에서 그 키를 삭제하는 순간 무효가 됩니다. 되돌리려 애쓰지 말고 그냥 새로 발급받으세요.

공짜로 얼마나 쓸 수 있나

둘 다 카드 등록 없이 시작할 수 있고, 한도를 넘으면 청구되는 게 아니라 잠시 막힙니다.

Groq 무료 등급 — 오늘 콘솔에서 확인한 실제 수치

설정 → Limits 에 들어가면 내 계정의 현재 한도가 이 표 그대로 나옵니다. RPM은 분당 요청 수, RPD는 하루 요청 수, TPM/TPD는 분·일 단위 토큰 수입니다.

모델분당 요청하루 요청분당 토큰하루 토큰
openai/gpt-oss-20b301,0008K200K
openai/gpt-oss-120b301,0008K200K
groq/compound3025070K무제한
qwen/qwen3.8-27b301,0008K200K
whisper-large-v3 (음성→텍스트)202,000오디오 28,800초/일

모델 종류와 수치는 수시로 바뀝니다. 내 계정 기준 최신 값은 console.groq.com/settings/limits 에서 보세요.

Gemini

무료 등급은 AI 스튜디오에서 확인

구글은 모델별 한도를 문서에 고정 수치로 적어두지 않습니다. 왼쪽 메뉴의 비율 제한을 누르면 내 프로젝트에 걸린 현재 한도가 그대로 나옵니다. 목록의 결제 등급이 "무료 등급"이면 카드가 안 걸려 있는 상태입니다.

한도 초과

돈이 나가는 게 아니라 잠깐 멈춥니다

둘 다 무료 등급에서 한도를 넘기면 429 오류가 돌아오고, 시간이 지나면 다시 풀립니다. 카드를 등록하지 않는 한 요금이 청구될 일은 없습니다.

마무리 점검과 문제 해결

여기까지 다 체크되면 끝난 겁니다.

키를 복사 안 하고 창을 닫아버렸어요

다시 볼 방법은 없습니다. 정상 절차는 그 키를 삭제하고 새로 만드는 것입니다. Groq은 목록 오른쪽 휴지통 아이콘, Gemini는 줄 끝 ⋮ 메뉴에서 삭제할 수 있어요. 키를 여러 개 만들어도 괜찮습니다.

"The request is suspicious" / "failed to create api key" 가 떠요

키를 만드는 순간에만 나오는 봇 탐지입니다. 이 가이드를 만들면서 자동 클릭으로 시도했더니 양쪽 다 정확히 이 메시지로 막혔어요.

사람이 직접 클릭하면 보통 그냥 됩니다. 그래도 뜨면 VPN을 끄고, 시크릿 창에서, 자동화 계열 확장 프로그램을 잠시 끈 뒤 다시 시도해 보세요.

401 Invalid API Key 가 나와요

거의 항상 복사 사고입니다. 순서대로 확인하세요.

① 앞뒤에 공백이나 줄바꿈이 끼었는지 · ② 따옴표를 같이 붙여넣었는지 · ③ Groq 키를 Gemini 자리에 넣지 않았는지 (gsk_ ↔ AIza) · ④ 키 일부만 잘라 붙였는지.

429 Rate limit 이 나와요

무료 한도를 넘긴 겁니다. 요금이 청구된 게 아니라 잠시 막힌 상태예요. 분당 한도면 1분, 하루 한도면 다음 날 풀립니다. 급하면 한도가 더 큰 다른 모델로 바꾸면 됩니다.

둘 중 뭘 써야 하나요

Groq은 속도가 강점입니다. 응답이 눈에 띄게 빨라서 챗봇처럼 실시간 반응이 중요한 데 좋아요. 대신 오픈소스 모델만 돌립니다.

Gemini는 모델 자체가 더 똑똑하고, 이미지·긴 문서·음성까지 한 번에 다룹니다. 복잡한 작업이면 이쪽입니다.

둘 다 무료니까 키를 양쪽 다 받아두고 상황 따라 바꿔 쓰는 게 제일 낫습니다.

키를 실수로 깃허브에 올렸어요

커밋을 지워도 소용없습니다 — 올라간 순간 봇이 긁어갔다고 보는 게 맞아요. 지금 바로 콘솔에서 그 키를 삭제하세요. 삭제하면 그 키로는 아무것도 못 합니다. 그 다음 새 키를 발급받고, 이번엔 .gitignore 를 먼저 만드세요.