제미나이(Gemini) API 키 발급 — AI Studio에서 받고 막힐 때 푸는 법

Google Cloud를 처음 쓰는 계정이면 AI Studio에서 약관에 동의할 때 기본 프로젝트와 API 키가 저절로 생겨요. API Keys 화면에서 그 키를 복사하면 끝이에요. 키가 더 필요하면 「Create API key」를 눌러 키와 프로젝트를 한 쌍으로 만들어요.

2026년 5월 28일부터 AI Studio에서 새로 만드는 키는 모두 승인 키(auth 키)예요. 그 전에 만든 표준 키는 제한을 걸어 둬야 계속 돌아요.

AI Studio는 가져온 프로젝트만 보여 줘요. 쓰던 프로젝트나 키가 안 보이면 「Import projects」부터 해요.

AI Studio에는 제한이 없거나 Gemini API로만 묶인 키만 보여요. 다른 Google API에 쓰도록 제한을 건 키는 Google Cloud 콘솔의 credentials 화면에서 봐요.

1. 1Google AI Studio에 로그인해 서비스 약관에 동의해요. 처음 쓰는 계정이면 기본 프로젝트와 키가 이때 생겨요.
2. 2왼쪽 대시보드의 API Keys 화면에서 키를 복사해요.
3. 3이미 Google Cloud를 쓰던 계정이면 기본 프로젝트가 생기지 않아요. 대시보드의 Projects에서 「Import projects」를 눌러 쓸 프로젝트를 찾아 「Import」해요.
4. 4가져온 프로젝트를 고르고 API Keys 화면에서 「Create API key」로 키를 만들어요.

API Keys 화면의 「Key Type」 칸에 Standard로 적힌 키가 표준 키예요. 그중 「Unrestricted」 라벨이 붙은 키를 Gemini API가 거절해요. 그 키를 Gemini API에만 쓴다면 키를 바꾸지 않고 제한만 걸어도 돼요.

1. 1API Keys 화면에서 「Unrestricted」 라벨이 붙은 키를 찾아요.
2. 2라벨에 마우스를 올려 뜬 창에서 「Add restrictions」를 눌러요.
3. 3「Restrict to Gemini API only」를 고르고 「Restrict key」로 확인해요.

승인 키로 보낸 요청은 Google Cloud 서비스 계정 사용량 지표에 잡히지 않아요. 그 지표로 호출 수를 세던 팀은 옮긴 뒤 숫자가 비는 것을 미리 알아 둬요.

1. 1API Keys 화면의 「Key Type」 칸에서 Standard로 적힌 키를 찾아요.
2. 2「Create API key」로 새 키를 만들어 복사해요. 새로 만드는 키는 모두 승인 키예요.
3. 3앱 코드·환경변수·배포 설정에 들어 있던 옛 키를 새 키로 바꿔 넣어요.
4. 4앱이 새 키로 도는지 시험해요.
5. 5확인한 뒤에 옛 키를 지우거나 꺼요.

Google 공식 SDK는 GEMINI_API_KEY나 GOOGLE_API_KEY 환경변수를 알아서 읽어요. 둘 다 있으면 GOOGLE_API_KEY를 먼저 써요. 코드에서 키를 직접 넘기지 않았다면, 새 키를 GEMINI_API_KEY에 넣어도 옛 키가 GOOGLE_API_KEY에 남아 있을 때 SDK는 그 옛 키로 불러요.

export 는 지금 연 터미널에서만 살아 있어요. 계속 쓰려면 같은 줄을 ~/.zshrc(맥 기본 셸)나 ~/.bashrc 끝에 넣고 source ~/.zshrc 로 다시 읽어요. Windows는 검색창에서 「환경 변수」를 찾아 사용자 변수에 GEMINI_API_KEY를 새로 만들고, 터미널을 새로 열어야 읽혀요.

키를 코드에 직접 적는 건 환경변수를 쓸 수 없을 때만이에요. 웹·모바일 앱 화면 코드에 넣은 키는 사용자가 꺼낼 수 있어서, 그런 앱은 서버를 거쳐 불러요.

파이썬 SDK는 google-genai예요. 예전 패키지 google-generativeai는 2025년 11월 30일부로 지원이 중단(deprecated)됐고 더는 관리되지 않아요.

# 1) 지금 터미널에 키 넣기 — 따옴표 안에 AI Studio에서 복사한 키
export GEMINI_API_KEY="여기에_복사한_키"

# 2) 옛 키가 GOOGLE_API_KEY 에 남았는지 확인 — 값은 찍지 않아요
[ -n "$GOOGLE_API_KEY" ] && echo "GOOGLE_API_KEY 가 있어요. SDK 는 이 값을 먼저 써요."

# 3) 한 번 불러 보기 — Google 시작 안내의 예시 그대로
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Explain how AI works in a few words"
  }'

회사·학교 Google 계정에서 「We are sorry, but you do not have access to Google AI Studio. Please contact your Organization Administrator for access.」가 보이면 Workspace 관리자가 그 계정에 AI Studio를 꺼 둔 경우가 많아요. 관리자에게 물어요. AI Studio는 모든 에디션에서 기본으로 켜져 있고, 관리자가 조직 단위로 끄고 켜요. Workspace for Education의 만 18세 미만 계정은 켜 둬도 AI Studio를 쓸 수 없어요.

원포트 AI 키는 스쿨오더·오피스오더 「AI API」 화면에서 지갑 주인이 「키 만들기」로 만들어요. 키는 sk-so- 로 시작하고 원문은 만들 때 한 번만 보여요. 사람마다 키를 만들고, 키마다 한 달 한도를 걸 수 있어요.

원포트 AI는 OpenAI 형식 주소(https://oneport.kr/v1)로 불러요. Google SDK(google-genai)나 x-goog-api-key 형식으로는 붙지 않아서, 쓰던 OpenAI SDK의 base_url과 키만 바꿔요. 모델 이름은 /v1/models 에서 확인해요.

모델을 정하지 않은 「원포트 AI API 크레딧」이나 제미나이 팩으로 산 크레딧은 모든 모델을 불러요. 클로드·GPT 팩으로 산 크레딧은 제미나이를 뺀 모든 모델을 불러요.

curl https://oneport.kr/v1/chat/completions \
  -H "Authorization: Bearer $ONEPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.8-flash",
    "messages": [{"role": "user", "content": "안녕하세요"}]
  }'