# Google AI Studio API 키 발급: 프로젝트 선택부터 첫 호출까지

> Google AI Studio API 키 발급은 무료입니다. 무료 등급에서 Gemini 3.8 Flash 등을 쓸 수 있고, 이미지 모델과 3.1 Pro는 결제 연결이 필요합니다.

- URL: https://blog.laozhang.ai/ko/posts/google-ai-studio-api-key
- Published: 2026-08-29
- Updated: 2026-10-08
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ko/about)
- Topic: API 가이드
- Tags: Google AI Studio, Gemini API, API 키, Google Cloud, 시크릿 관리

---
2026년 10월 8일 기준으로 Google AI Studio에서 Gemini API 키를 발급하는 데는 비용이 들지 않습니다. 2026년 5월 28일 이후 새로 만드는 키는 모두 인증 키(auth key)이고, 제한 없는 표준 키로 보낸 요청은 거부됩니다. 무료 등급에서도 `gemini-3.8-flash`로 첫 요청을 보낼 수 있으므로, 결제를 연결하기 전에 키와 프로젝트 설정부터 확인할 수 있습니다.

키를 발급한 뒤에는 연결 설정까지 확인해야 합니다. 키가 관리 가능한 Google Cloud 프로젝트에 속하는지, 클라이언트 코드 밖에 안전하게 보관되어 있는지 확인하고 작은 Gemini Developer API 요청을 보내세요. API 키는 Gemini 소비자 구독이 아니며, 키마다 별도 무료 쿼터가 생기는 상품도 아닙니다. 프로젝트에 연결된 인증 수단입니다.

## 먼저 계정과 프로젝트를 맞춘다

Google의 현재 [AI Studio와 Gemini API 지원 지역](https://ai.google.dev/gemini-api/docs/available-regions)에서 실제 사용 지역을 확인합니다. 2026년 10월 8일 기준 목록에 대한민국이 포함되어 있습니다. 다만 국가가 목록에 있다고 해서 개별 계정의 18세 이상 요건, 연령 확인, 조직 정책, 결제 적격성까지 보장되지는 않습니다. AI Studio가 계정에 표시하는 안내도 충족해야 합니다.

그다음 [Google AI Studio API 키 화면](https://aistudio.google.com/apikey)을 해당 프로젝트를 소유하거나 정당하게 관리할 계정으로 엽니다. 회사 서비스라면 개인 Gmail이 아니라 조직이 결제, IAM, 키 교체, 폐기를 계속 관리할 수 있는 계정을 선택합니다.

[Gemini API 키 문서](https://ai.google.dev/gemini-api/docs/api-key)에 따르면 모든 키는 Google Cloud 프로젝트에 속합니다. 신규 사용자는 약관에 동의하면 기본 Cloud 프로젝트와 API 키를 자동으로 받습니다. 이미 Google Cloud를 사용하는 계정은 기본 프로젝트가 생성되지 않을 수 있으며, **Dashboard → Projects → Import projects**에서 대상 프로젝트를 가져온 뒤 API 키 화면에서 키를 생성합니다.

표시 이름보다 프로젝트 ID를 기록하세요. 이후 배포 환경, 사용량, 결제와 할당량을 대조할 때 같은 이름의 프로젝트를 혼동하지 않게 해 줍니다. 결제 등급과 한도도 키가 아니라 프로젝트를 따라가므로, 어떤 프로젝트에서 키를 만드는지가 곧 무료로 쓸지 유료로 쓸지를 정합니다.

**Create API key** 버튼에 권한 부족 메시지가 표시되면 반복 클릭하지 않습니다. 프로젝트 조회, 키 생성, 서비스 활성화, 서비스 계정 생성, 키 연결 권한을 프로젝트 관리자와 확인합니다. 다른 사람의 키를 받는 것은 IAM 문제를 해결하지 못합니다.

## 새 키는 인증 키인지 확인한다

2026년 5월 28일부터 AI Studio에서 새로 만드는 키는 모두 인증 키(authorization key, auth key)로 생성됩니다. 인증 키는 서비스 계정에 연결되고 기본적으로 Gemini API에만 쓸 수 있도록 제한되며, 유출이 확인되면 더 빠르게 차단됩니다.

예전에 만든 표준 키(standard API key)는 제한 여부에 따라 결과가 갈립니다. Gemini API는 제한 없는 표준 키의 요청을 거부하고, 명시적인 제한이 걸린 표준 키는 계속 받아 줍니다. 오래된 튜토리얼에서 복사한 키나 몇 달 전에 만든 키로 요청이 거부된다면, 새 인증 키를 만들거나 기존 키에 제한을 거는 것이 먼저입니다. 생성 후에는 키 목록의 **Key Type** 열에서 유형을 확인합니다.

![계정과 Cloud 프로젝트 확인부터 인증 키 발급, 서버 보관, 시험 요청, 오류 진단까지 이어지는 흐름](https://blog.laozhang.ai/posts/ko/google-ai-studio-api-key/img/setup-and-canary.webp)

*이 그림은 2026년 10월 8일 수정 전에 만들어져 "2026년 9월부터 표준 키 거부"와 `gemini-3.7-flash` 예제가 남아 있습니다. 현재 내용은 본문 기준입니다.*

## 키는 코드 밖에 안전하게 보관한다

키가 유출되면 다른 사람이 프로젝트 쿼터를 소비하고, 결제가 연결된 프로젝트라면 비용을 만들 수 있습니다. 다음 위치에는 넣지 않습니다.

- Git 저장소와 커밋 이력
- 운영 브라우저 JavaScript, 모바일 앱, 공개 확장 프로그램
- 이슈, 채팅, 화면 캡처, 환경 변수 전체 출력
- 분석과 프록시 로그에 남는 쿼리 문자열

로컬 개발에서는 `GEMINI_API_KEY` 또는 `GOOGLE_API_KEY`를 사용할 수 있습니다. 둘 다 설정되면 `GOOGLE_API_KEY`가 우선합니다. 예전 값이 남아 있으면 새 키를 설정해도 요청이 바뀌지 않은 것처럼 보일 수 있습니다.

```bash
export GEMINI_API_KEY="YOUR_API_KEY"
```

실제 서비스에서는 서버 측 비밀 관리 도구에 키를 저장하고, 브라우저나 모바일 앱은 자체 백엔드를 호출하게 합니다. 키 값을 출력하지 않고도 환경 변수가 설정되어 있는지 확인할 수 있습니다.

```bash
if [ -n "${GEMINI_API_KEY:-}" ]; then
  echo "GEMINI_API_KEY is set"
else
  echo "GEMINI_API_KEY is missing"
fi
```

키가 저장소나 화면 캡처에 노출됐다면 새 키를 먼저 만들어 배포하고, 새 키로 요청이 성공하는 것을 확인한 다음 옛 키를 삭제합니다. 순서를 바꾸면 새 키가 배포될 때까지 서비스가 멈춥니다. 마지막으로 AI Studio의 사용량과 결제 내역에서 본인이 보내지 않은 요청이 있었는지 확인합니다.

## 현재 예제로 첫 요청을 보낸다

2026년 10월 8일 기준 Google의 [get-started 문서](https://ai.google.dev/gemini-api/docs/get-started)는 Interactions 엔드포인트와 `gemini-3.8-flash`를 사용합니다. 이 모델은 무료 등급에서도 호출할 수 있어, 결제를 연결하지 않은 새 프로젝트로도 같은 요청을 시험할 수 있습니다. 키는 URL이 아닌 헤더로 보냅니다.

```bash
curl -sS -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": "API 연결이 동작했음을 한 문장으로 확인해 주세요."
  }'
```

모델이 특정 문장을 그대로 출력하는지는 연결 성공의 기준이 아닙니다. 올바른 호스트와 프로젝트 키를 사용했는지 확인한 뒤, 응답에 완료 상태와 모델 출력이 있는지 살펴보세요.

첫 요청에 이미지 모델이나 Gemini 3.1 Pro Preview를 넣으면 무료 등급 프로젝트에서는 실패합니다. 키가 잘못된 것이 아니라 그 모델이 무료 등급에서 제공되지 않기 때문입니다. 연결 확인은 무료 등급에서 쓸 수 있는 Flash 모델로 하고, 유료 모델은 결제 연결 뒤에 시험합니다. 모델 ID와 엔드포인트는 바뀔 수 있으니 get-started 문서의 모델이 달라졌다면 그 예제로 시험 요청을 갱신하세요.

## 오류를 정보로 바꾸는 순서

첫 실패에서 HTTP 상태, 키를 제거한 오류 본문, 프로젝트 ID, 엔드포인트, 모델, UTC 시각, 요청 ID를 기록합니다. 키 전체나 전체 환경은 기록하지 않습니다. 한 번에 하나만 바꾸고 같은 시험 요청을 반복합니다.

| 보이는 결과 | 먼저 확인할 범위 | 최소 다음 행동 |
|---|---|---|
| 키 관리 화면 전에 차단 | 지역, 연령 확인, 계정/조직 정책 | 공식 조건을 다시 확인하고 이용 자격이 없다면 진행 중단 |
| Create 버튼 비활성 | 프로젝트 가져오기, IAM | 프로젝트 ID를 고정하고 필요한 권한 요청 |
| 오래된 키로 요청 거부 | 키 유형과 제한 설정 | AI Studio에서 새 인증 키 발급 또는 기존 표준 키에 제한 적용 |
| `403 PERMISSION_DENIED` | 실제 사용 키, 프로젝트, 제한 설정, 요청 작업 | [403 진단 절차](https://blog.laozhang.ai/ko/posts/gemini-api-key-permission-denied) 실행 |
| `429 RESOURCE_EXHAUSTED` | 프로젝트·모델·등급별 실제 한도 | AI Studio 값과 [요청 한도 가이드](https://blog.laozhang.ai/ko/posts/gemini-api-rate-limits-guide) 확인 |
| 이미지 모델에서 429 또는 한도 0 | 무료 등급 여부, 결제 연결 | [Gemini 이미지 429 오류 해결](https://blog.laozhang.ai/ko/posts/gemini-image-429-rate-limit)에서 원인 구분 |
| 모델·엔드포인트를 찾을 수 없음 | 현재 모델 ID와 API 버전 | 공식 get-started 예제로 한 번 재시도 |
| 일시적 서버 오류 | 서비스 상태, 재시도 정책 | 제한된 지수 백오프, 새 키 생성 금지 |

이 분리는 중요합니다. 키가 유효해도 할당량은 부족할 수 있고, 프로젝트가 유료여도 다른 환경 변수가 오래된 키를 가리킬 수 있습니다.

![프로젝트 관리 주체, Key Type, 키 보관 위치, 진단 증거, 실제 한도, 결제, 키 교체를 점검하는 운영 가이드](https://blog.laozhang.ai/posts/ko/google-ai-studio-api-key/img/operations-and-guardrails.webp)

*이 그림은 2026년 10월 8일 수정 전에 만들어져 "2026년 9월 표준 키 거부 예정"과 `gemini-3.7-flash` 예제가 남아 있습니다. 현재 내용은 본문 기준입니다.*

## 무료와 유료 결정은 연결 확인 다음이다

키 발급 자체에는 별도 "키 가격"이 없습니다. 비용은 키가 아니라 키가 속한 프로젝트의 결제 등급과 호출한 모델에 따라 생깁니다. 같은 프로젝트에서 키를 추가로 만들어도 독립 쿼터가 생기지 않습니다.

[Gemini API 요금표](https://ai.google.dev/gemini-api/docs/pricing)의 2026년 10월 8일 기준 무료 등급 범위는 다음과 같습니다.

| 구분 | 모델·기능 |
|---|---|
| 무료 등급에서 사용 가능 | Gemini 3.8 Flash, 3.7 Flash, 3.6 Flash, 3.5 Flash, 3.5 Flash-Lite, 3.1 Flash-Lite, 2.5 Pro, 2.5 Flash, 2.5 Flash-Lite, Live·TTS 계열 일부, Gemma 4 |
| 결제 연결 필요 | Gemini 3.1 Pro Preview, Gemini Omni Flash, Nano Banana 계열을 포함한 모든 이미지 모델 |
| 무료 등급에서 제공 안 됨 | Batch, Flex, Google 검색·지도 그라운딩 |

무료 등급에서 보낸 입력과 출력은 Google 제품 개선에 사용될 수 있고, 유료 등급은 사용되지 않습니다. 회사 데이터나 고객 데이터를 다룬다면 이 차이만으로도 결제 연결을 검토할 이유가 됩니다.

RPM·TPM·RPD 같은 모델별 한도는 공개 표로 고정되어 있지 않습니다. [Gemini API 사용량 한도 문서](https://ai.google.dev/gemini-api/docs/rate-limits)는 선택한 프로젝트의 실제 한도를 [AI Studio 한도 화면](https://aistudio.google.com/rate-limit)에서 보라고 안내합니다. 프로젝트에 활성 결제 계정을 연결하면 Tier 1이 되고, 보통 바로 적용됩니다. Tier 1에는 월 $250 결제 상한과 10분당 $10 지출 상한이 있습니다. 무료로 어디까지 쓸 수 있는지는 [Gemini API 무료 사용 한도 2026](https://blog.laozhang.ai/ko/posts/gemini-api-free-tier)에서 이어서 확인할 수 있습니다.

시험 요청이 성공한 뒤 실제 입력/출력량과 필요한 처리량을 측정하고 결제 연결 여부를 결정합니다. 비용 판단은 [Gemini API 가격 가이드](https://blog.laozhang.ai/ko/posts/gemini-api-pricing)와 현재 [공식 요금표](https://ai.google.dev/gemini-api/docs/pricing)를 사용합니다.

운영 전에 프로젝트 ID, 키 관리 주체, Key Type, 보관 위치, 교체 담당자, 허용된 백엔드, 모델, AI Studio의 실제 한도와 결제 상태를 기록하세요. 문제가 생겼을 때 누가 어떤 키를 폐기해야 하는지도 정해 두면 됩니다.

## Google AI Studio API 키 자주 묻는 질문

### Google AI Studio API 키는 무료인가요?

키 발급은 무료입니다. 결제를 연결하지 않은 프로젝트는 무료 등급으로 동작하며 Gemini 3.8 Flash 같은 Flash 모델을 한도 안에서 호출할 수 있습니다. 이미지 모델과 Gemini 3.1 Pro Preview는 결제를 연결해야 쓸 수 있고, 그때부터 호출량에 따라 비용이 청구됩니다.

### Gemini API 키는 어떻게 발급하나요?

관리할 Google 계정으로 aistudio.google.com/apikey를 열고, 키를 둘 Cloud 프로젝트를 고른 뒤 **Create API key**를 누릅니다. 신규 사용자는 약관 동의 후 기본 프로젝트와 키가 자동으로 만들어지고, 기존 Google Cloud 사용자는 프로젝트를 가져온 다음 키를 만듭니다.

### Google AI Studio API 키는 정확히 무엇인가요?

Gemini API를 호출할 때 어느 Google Cloud 프로젝트의 요청인지 증명하는 자격 증명입니다. Gemini 앱 구독과는 별개이고, 한도와 결제는 키가 아니라 프로젝트 단위로 적용됩니다. 2026년 5월 28일 이후 새로 만든 키는 Gemini API로 제한된 인증 키입니다.

## 참고 자료

이 글이 링크한 외부 페이지를 본문에 나온 순서대로 정리했습니다. 마지막 업데이트: 2026-10-08.

- [AI Studio와 Gemini API 지원 지역](https://ai.google.dev/gemini-api/docs/available-regions) (ai.google.dev)
- [Google AI Studio API 키 화면](https://aistudio.google.com/apikey) (aistudio.google.com)
- [Gemini API 키 문서](https://ai.google.dev/gemini-api/docs/api-key) (ai.google.dev)
- [get-started 문서](https://ai.google.dev/gemini-api/docs/get-started) (ai.google.dev)
- [Gemini API 요금표](https://ai.google.dev/gemini-api/docs/pricing) (ai.google.dev)
- [Gemini API 사용량 한도 문서](https://ai.google.dev/gemini-api/docs/rate-limits) (ai.google.dev)
- [AI Studio 한도 화면](https://aistudio.google.com/rate-limit) (aistudio.google.com)