제미나이 API 가격·무료 한도·키 발급 2026, 생각 낮추면 8배 싸요

제미나이 API 는 구글 AI Studio 에서 키를 받으면 무료로 시작할 수 있어요. 유료는 3.8 Flash 기준 100만 토큰당 입력 0.75달러, 출력 3.75달러예요. 가장 큰 모델인 제미나이 4 아르곤은 입력 2달러, 출력 10달러이고 12월 1일부터 두 배가 돼요(2026-11-03 구글 가격표 확인). 직접 재 보니 3.8 Flash 는 두 문장 요약에도 출력의 90% 가까이를 혼자 생각하는 데 썼어요. 설정 한 줄로 생각을 낮추자 같은 요약이 8~9배 싸졌어요. 키 발급 순서, 토큰 수 확인법, 무료 한도와 초기화 시간, 429 오류, 12월에 바뀌는 것까지 차례로 정리했어요.

마지막 확인 2026-11-03 · 글쓴이 서순명(솔리드그루 이사 · 퓨쳐인프라는 국내 IDC 에서 클라우드 서버를, 300종 넘는 AI 모델을 키 하나로 쓰는 AI 라우터를 운영) · 운영사 솔리드그루(사업자등록번호 875-44-00335) · 문의 support@futureinfra.ai · 02-6933-6229 · 처음 작성 2026-09-29 · 가격·한도는 구글 직접 결제의 표준(Standard) 등급·달러 기준이고, 바뀌면 고친 뒤 이 날짜를 바꿔요

제미나이 API 키는 어떻게 발급해요?

구글 계정만 있으면 돼요. 카드 등록 없이 무료 구간으로 시작해요. 아래 순서는 구글 API 키 안내(2026-11-03 확인)를 따랐어요.

1. AI Studio 에 로그인해요. aistudio.google.com 에 구글 계정으로 들어가 약관에 동의해요. 처음 쓰는 사람은 기본 프로젝트와 API 키가 저절로 하나 만들어져요.
2. API 키 화면을 열어요. 왼쪽 대시보드에서 API Keys(aistudio.google.com/apikey)를 눌러요.
3. 키를 만들어 복사해요. Create API key 를 누르고 프로젝트를 골라요. 나온 키를 복사해 두세요.
4. 환경변수에 넣어요. 코드에 키를 직접 적지 말고 GEMINI_API_KEY 에 두면 공식 SDK 가 알아서 읽어요.

# 맥·리눅스 터미널
export GEMINI_API_KEY="발급받은_키"

# 윈도우 PowerShell(지금 연 창에서만)
$env:GEMINI_API_KEY="발급받은_키"

2026년 5월 28일부터 AI Studio 에서 새로 만드는 키는 모두 인증 키(auth key)예요. 서비스 계정에 묶여 있어서, 키가 밖으로 새면 구글이 빨리 막아 줘요. 키를 여러 개 만들어도 무료 한도는 늘지 않아요(아래 "무료 토큰" 참고).

제미나이 API 는 어떻게 시작해요?

키를 받았다면 남은 건 두 가지예요. 코드에 키를 넣고, 모델 이름을 적으면 돼요. OpenAI 방식 코드를 이미 쓰고 있다면 주소만 바꿔도 돼요(구글 OpenAI 호환 안내).

from openai import OpenAI

client = OpenAI(
    api_key="제미나이_API_키",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
)
r = client.chat.completions.create(
    model="gemini-3.8-flash",
    reasoning_effort="low",          # 생각 낮추기 — 쉬운 일이면 이 한 줄로 값이 크게 줄어요
    messages=[{"role": "user", "content": "다음 글을 두 문장으로 요약해 줘: ..."}],
)
print(r.choices[0].message.content)
print(r.usage)                       # 이번 요청에 쓴 토큰 수

구글 공식 SDK(pip install -U google-genai)를 쓸 때는 설정 이름이 thinking_level 이에요. 제미나이 3.8 Flash 는 기본값이 medium(보통)이고, low·medium·high 를 고를 수 있어요. 가장 낮은 minimal 은 3.8 Flash 에서 오류가 나요.

표는 구글 생각(thinking) 설정 안내(2026-11-03 다시 확인) 기준이에요. OpenAI 방식의 reasoning_effort 는 이 단계로 바뀌어 들어가요. 3세대 모델은 생각을 아예 끌 수는 없어요. 가장 낮은 단계로 줄일 수만 있어요.

새로 시작한다면 모델은 3.8 Flash 나 3.5 Flash-Lite 를 고르세요. 2.5 세대는 끝나 가요. 구글 릴리스 노트(11월 2일)를 보면 2.5 Pro 와 2.5 Flash 는 지원 종료(deprecated)가 됐어요. 12월 1일부터 2.5 Pro 로 보낸 요청은 3.8 Flash 로, 2.5 Flash 로 보낸 요청은 3.5 Flash-Lite 로 저절로 넘어가고 넘어간 모델 값으로 청구돼요.

터미널에서 바로 불러 보려면 — gemini-api CLI

구글이 10월 27일 제미나이 API CLI(gemini-api)를 베타로 내놨어요. 코드를 짜지 않고 터미널 명령 한 줄로 글·그림을 만들고 파일을 읽혀요. 클로드 코드·커서 같은 코딩 도구가 대신 부르기 좋게 만든 도구예요. 아래는 구글 CLI 안내의 명령이고, 우리가 직접 돌려 보지는 않았어요.

# 맥·리눅스 설치
curl -fsSL https://raw.githubusercontent.com/google-gemini/gemini-api-cli/main/scripts/install.sh | bash
# 윈도우 PowerShell 설치
iwr -useb https://raw.githubusercontent.com/google-gemini/gemini-api-cli/main/scripts/install.ps1 | iex

# 키를 넣고 써 보기
export GEMINI_API_KEY="발급받은_키"
gemini-api analyze -i ./report.pdf "핵심 세 줄로 요약해 줘"

베타라서 작은 버전 사이에도 명령이 바뀔 수 있어요. 자동화에 넣는다면 버전을 고정하라고 안내해요. 채팅하듯 쓰는 제미나이 CLI(gemini-cli)와는 다른 도구예요.

제미나이 토큰이란 무엇인가요?

토큰은 AI 가 글을 읽고 쓰는 가장 작은 조각이에요. 짧은 낱말은 한 조각, 긴 낱말은 여러 조각으로 잘려요. 구글 토큰 문서에는 영어 기준으로 1토큰이 약 4글자, 100토큰이 영어 단어 60~80개쯤이라고 적혀 있어요.

한국어는 더 잘게 잘려요. 우리가 9월 29일 실제로 보낸 요약 부탁은 띄어쓰기 포함 221자였어요. 응답에 찍힌 입력 토큰은 121개였어요. 한국어 약 1.8자가 1토큰이었던 셈이에요. 한 번 잰 값이고 질문 앞뒤에 붙는 형식 토큰도 섞여 있어요. 그래도 어림하기엔 쓸 만해요.

쉽게 말하면 한국어 글 1만 자를 보내면 입력 토큰이 5,500개 안팎 나와요. 3.8 Flash 유료 가격으로 약 5.4원이에요. 무거운 쪽은 글보다 긴 답과 생각이에요.

한 번에 몇 토큰까지 넣고 받을 수 있어요?

제미나이 3.8 Flash 모델 정보를 보면 한 번에 입력 1,048,576토큰, 출력 65,536토큰까지예요. 한국어로 치면 입력은 책 몇 권 분량이에요. 제미나이 4 아르곤은 입력과 출력을 합쳐 100만 토큰을 같이 써요. 출력은 기본 65,536토큰이고, 긴 출력 기능을 켜면 더 길게 받을 수 있어요.

제미나이 토큰 수는 어떻게 확인해요?

확인하는 곳은 네 군데예요. 언제 알고 싶은지에 따라 고르면 돼요.

① 보내기 전에 세기 — count_tokens

질문을 보내기 전에 입력이 몇 토큰인지 미리 세어 줘요. 긴 문서를 넣기 전에 한도를 넘지 않는지 볼 때 좋아요. 아래는 구글 공식 문서의 예시를 옮기고 질문만 한국어로 바꾼 거예요. 우리 키로 직접 돌려 보지는 않았어요.

# 구글 공식 예시(파이썬) — 2026-10-27 문서 기준
from google import genai

client = genai.Client()              # 환경변수 GEMINI_API_KEY 를 읽어요
prompt = "서버 스냅샷과 백업의 차이를 알려 줘."

total = client.models.count_tokens(model="gemini-3.8-flash", contents=prompt)
print(total)                          # 입력 토큰 수만 나와요

response = client.models.generate_content(model="gemini-3.8-flash", contents=prompt)
print(response.usage_metadata)        # 실제로 쓴 입력·출력·생각 토큰

대화형 채팅이라면 지금까지의 대화 기록에 다음 질문을 붙여서 세야 해요. 다음 한 번이 얼마나 커질지 알 수 있어요. 그림·영상을 같이 넣을 때도 같은 함수로 세요. 이 함수는 입력만 세요. 답이 몇 토큰 나올지는 미리 알 수 없어요.

② 받은 뒤 확인하기 — usage_metadata

응답마다 토큰 영수증이 붙어 와요. 필드 이름만 알면 돼요.

구글이 새로 내놓은 Interactions API 를 쓰면 이름이 조금 달라요. interaction.usage 안에 total_input_tokens·total_output_tokens·total_thought_tokens·total_cached_tokens·total_tokens 가 있어요. OpenAI 방식으로 받으면 usage 에 담겨 와요. 우리 AI 라우터로 받은 실제 응답에는 prompt_tokens·completion_tokens, 그리고 생각 토큰인 completion_tokens_details.reasoning_tokens 가 찍혔어요. 라우터를 거치면 이름만 OpenAI 형식으로 바뀌고 세는 대상(입력·답·생각)은 같아요.

③ 쌓인 사용량 보기 — AI Studio 화면

며칠·몇 주 동안 쓴 양은 AI Studio 에서 봐요. 구글 결제 안내 기준으로 대시보드 > 사용량(Usage) 메뉴예요. 주소는 aistudio.google.com/usage 예요. 남은 한도는 aistudio.google.com/rate-limit 화면에 모델별로 나와요. 둘 다 로그인해야 열려요.

④ 제미나이 앱(채팅)에서 남은 사용량 보기

API 말고 gemini.google.com 채팅을 쓴다면 방법이 달라요. 왼쪽 아래 설정 > 사용량 한도에서 봐요. 앱 한도는 토큰 개수 대신 계산량으로 매겨서, 질문 길이·모델·기능에 따라 빨리 닳기도 해요. 구글 도움말 기준으로 한도는 5시간마다 다시 차고, 따로 주간 한도가 있어요. 한 대화에서 기억하는 양은 요금제마다 달라요. 무료는 3만 2천 토큰, AI Plus 는 12만 8천 토큰, AI Pro·Ultra 는 100만 토큰이에요. 앱 구독은 API 한도와 따로 움직여요.

무료로 쓰면 뭐가 달라요?

구글 공식 가격표를 보면 제미나이 3.8 Flash 는 무료 구간이 있어요. 입력·출력 모두 무료예요. 대신 무료 구간에서 보낸 내용은 구글 제품 개선에 쓰일 수 있다고 적혀 있어요. 유료 구간은 쓰이지 않아요. 회사 자료나 고객 정보를 넣는다면 유료로 쓰는 게 안전해요. 무료 구간은 쓸 수 있는 횟수에도 한도가 있어요.

무료 토큰은 몇 개까지예요?

무료 구간은 "몇 토큰까지"로 막지 않고 RPM·TPM·RPD 세 가지로 막아요. 셋 중 하나만 넘어도 오류가 나요. 예를 들어 1분에 20번이 한도면 21번째 요청은 막혀요. 토큰 한도가 남아 있어도요. 숫자는 모델과 계정 등급마다 다르고 바뀌어요. 구글 한도 문서도 표 대신 AI Studio 의 한도 화면을 보라고 안내해요.

• 키를 여러 개 만들어도 늘지 않아요. 한도는 키마다 따로 있지 않고 프로젝트에 붙어요.
• 무료 구간이 없는 모델도 있어요. 제미나이 4 아르곤과 3.1 Pro 미리보기는 유료로만 써요.
• 유료로 바꾸려면 결제 계정을 연결해요. 새 계정은 보통 최소 5달러를 먼저 충전해요. 그러면 Tier 1 이 돼요.

한도는 언제 다시 차요?

하루 요청 수(RPD)는 미국 태평양 시간 자정에 다시 차요. 지금(11월 1일 미국 서머타임 종료 뒤)은 한국 시간 오후 5시예요. 서머타임이 시작되는 2027년 3월 14일부터는 오후 4시로 당겨져요. 1분 한도(RPM·TPM)는 1분이 지나면 풀려요.

표는 구글 한도 문서(2026-11-03 확인) 기준이에요. Tier 2 의 10분 지출 한도는 지난 수정(10월 27일) 때 적은 50달러에서 200달러로 올라 있었어요. 등급은 조건을 채우면 저절로 올라가요. 무료에서 Tier 1 은 바로, 그다음은 10분 안쪽으로 바뀌어요.

토큰당 요금은 얼마예요?

제미나이는 100만 토큰 단위로 값을 매겨요. 출력이 입력보다 5~8배 비싸요. 생각 토큰은 출력 값으로 계산해요. 2026년 11월 3일 구글 공식 가격표를 다시 열어 봤고, 10월 27일 값과 같았어요.

값을 더 줄이는 길도 있어요. 결과를 바로 받지 않아도 되는 일은 배치(Batch) 방식으로 보내면 3.8 Flash 기준 반값이에요. 같은 긴 문서를 여러 번 넣는다면 캐시를 써요. 다시 넣는 입력이 10분의 1 값이에요. 대신 캐시를 붙잡아 두는 시간만큼 보관료가 따로 붙어요.

처리 속도를 골라 값을 바꾸는 길도 있어요. 3.8 Flash 기준으로 Flex 는 입력 0.375달러·출력 1.875달러로 배치와 같은 반값이에요. 대신 붐비면 늦게 처리돼요. Priority 는 입력 1.35달러·출력 6.75달러로 표준의 1.8배이고, 붐빌 때 먼저 처리돼요. 4 아르곤도 같은 등급이 있어요(11월 30일까지 Flex 1달러·5달러, Priority 3.6달러·18달러).

생각을 낮추면 뭐가 달라져요?

같은 글을 두 문장으로 요약해 달라고 기본 설정으로 5번, 생각을 low 로 낮춰 5번 보냈어요.

제미나이 3.8 Flash 는 답하기 전에 스스로 생각하는 모델이에요. 기본 설정에서는 쉬운 요약에도 수백 토큰을 생각에 썼어요. 이 생각도 출력 요금으로 계산돼요. 두 줄짜리 메모를 부탁했는데, 연습장에 한 페이지를 쓰고 그 연습장 값까지 내는 셈이에요.

생각을 low 로 낮추자 생각 토큰이 0이 됐어요. 요약 다섯 개 모두 "스냅샷은 되돌리기 쉽지만 같은 저장소에 있어 따로 백업해야 한다"는 핵심을 그대로 담았어요. 품질 차이는 눈에 띄지 않았어요.

그래서 한 번에 얼마예요?

원화 값은 측정한 날 환율로 계산했어요. 10월 27일 환율(1,325원)로 다시 계산하면 2% 남짓 내려가요. 순서와 배수는 그대로예요.

제미나이 4 아르곤은 쉬운 일에도 비싸요?

11월 3일 같은 요약 부탁을 제미나이 4 아르곤과 3.8 Flash 에 기본 설정·low 로 3번씩 다시 보냈어요. 단가는 아르곤이 3.8 Flash 의 약 2.7배예요. 그런데 결과는 예상과 달랐어요.

아르곤은 이 요약에서 생각을 하지 않았어요. 기본 설정에서도 생각 토큰이 3번 모두 0이었어요. 우리 라우터에 찍힌 실제 청구액도 매번 4원으로, 답 토큰만큼만 나갔어요. 그래서 기본 설정끼리 비교하면 비싼 아르곤이 3.8 Flash 보다 오히려 쌌어요(1.43원 대 4.15원).

3.8 Flash 는 11월에도 기본 설정에서 출력 799토큰 중 736토큰(약 92%)을 생각에 썼어요. 9월 실측(710토큰 중 635토큰)과 비슷해요. 생각을 low 로 낮추면 0이 되고, 한 번 값이 0.45원로 네 가지 중 가장 쌌어요. low 로 받은 요약 세 개 모두 핵심(같은 저장소라 따로 백업해야 한다)을 담았어요.

똑똑한 모델이 쉬운 일엔 고민 없이 바로 답했고, 덜 비싼 모델은 쉬운 일에도 한참 고민하느라 돈을 더 썼어요. 쉬운 일이라면 3.8 Flash 에 low 를 거는 게 가장 싸고, 설정을 못 바꾸는 환경이라면 아르곤이 의외로 나쁘지 않았어요. 다만 이건 쉬운 요약 한 가지예요. 어려운 일에서는 아르곤도 생각을 많이 쓸 수 있어요.

같은 글인데 입력 토큰이 아르곤 143개, 3.8 Flash 121개로 달랐어요. 모델마다 글을 자르는 방식이 달라서예요. 아르곤 기준으로는 한국어 약 1.5자가 1토큰이었어요.

429 오류는 왜 나고 어떻게 풀어요?

429 Too Many Requests 는 "너무 많이, 너무 빨리 보냈다"는 뜻이에요. 키가 틀렸다는 뜻이 아니에요. 구글 오류 안내 기준으로 원인은 세 갈래예요.

• 다시 보낼 땐 간격을 늘려요. 1초, 2초, 4초, 8초처럼 늘리는 방식이에요. 구글 문서에 따르면 파이썬 공식 SDK 는 429 가 나면 알아서 최대 4번, 1초에서 60초까지 간격을 늘려 다시 보내요.
• 키를 늘리는 건 소용없어요. 같은 프로젝트의 키는 한도를 나눠 써요.
• 생각을 낮추면 덜 막혀요. 같은 일에 쓰는 토큰이 줄어 1분 한도에 늦게 닿아요.
• 급하지 않은 일은 배치로 보내요. 배치는 보통 요청과 따로 한도를 세요.

언제 생각을 켜 두고, 언제 낮춰요?

코드 없이 먼저 눌러 보려면 제미나이 3.8 Flash 플레이그라운드에서 로그인하고 5번 무료로 써 볼 수 있어요. 제미나이 다음 모델 소식은 제미나이 3.9 Flash 정리에, 다른 회사 모델 값은 클로드 가격과 무료 AI 모델 비교에 있어요. 제미나이로 그림을 만드는 길은 무료 AI 이미지 생성 비교에, 제미나이 CLI 에 MCP 를 붙이는 법은 MCP 연동 방법에 있어요.

자주 묻는 질문

제미나이 API 는 무료인가요?

제미나이 3.8 Flash 는 무료 구간이 있어요. 다만 무료 구간에서 보낸 내용은 구글 제품 개선에 쓰일 수 있고 사용 한도가 있어요. 유료는 100만 토큰당 입력 0.75달러, 출력 3.75달러예요.

제미나이 토큰 확인은 어디서 하나요?

보내기 전엔 count_tokens 로 입력 토큰을 세요. 받은 뒤엔 응답의 usage_metadata 를 봐요. 쌓인 사용량은 AI Studio 대시보드의 사용량 메뉴, 남은 한도는 한도(rate-limit) 화면에서 봐요.

제미나이 토큰 한도는 언제 초기화되나요?

API 의 하루 요청 한도는 미국 태평양 시간 자정에 다시 차요. 한국 시간으로 지금은 오후 5시, 미국 서머타임 기간(3월 둘째 일요일~11월 첫 일요일)에는 오후 4시예요. 제미나이 앱(채팅) 한도는 5시간마다 다시 차고 주간 한도가 따로 있어요.

한국어는 토큰을 더 많이 쓰나요?

네, 영어보다 잘게 잘려요. 구글 문서 기준 영어는 약 4글자가 1토큰이에요. 우리 실측에서는 한국어 약 1.8자가 1토큰이었어요.

API 키를 여러 개 만들면 무료 한도가 늘어나나요?

아니요. 구글 한도 문서에 한도는 프로젝트 단위라고 적혀 있어요. 같은 프로젝트의 키는 한도를 나눠 써요.

제미나이 4 아르곤도 무료로 쓸 수 있나요?

API 로는 무료 구간이 없어요. 100만 토큰당 입력 2달러, 출력 10달러이고, 2026년 12월 1일부터 입력 4달러, 출력 20달러가 돼요. 우리 실측에서 쉬운 요약은 생각 토큰 없이 한 번 1.4원 남짓이었어요.

제미나이 API 키 발급은 무료인가요?

네. AI Studio 에서 키를 만드는 데 돈이 들지 않고, 카드를 등록하지 않으면 무료 구간으로 써요. 무료 구간이 없는 모델(4 아르곤 등)을 쓰려면 결제 계정을 연결하고 최소 5달러를 먼저 충전해요.

제미나이 2.5 모델은 언제까지 쓸 수 있나요?

구글은 11월 2일 2.5 Pro 와 2.5 Flash 를 지원 종료로 바꿨어요. 12월 1일부터 2.5 Pro 요청은 3.8 Flash 로, 2.5 Flash 요청은 3.5 Flash-Lite 로 자동으로 넘어가고 그 모델 값으로 청구돼요.

코드 없이 터미널에서 제미나이 API 를 쓸 수 있나요?

구글이 10월 27일 베타로 낸 gemini-api CLI 를 깔면 명령 한 줄로 글·그림을 만들 수 있어요. 키는 같은 GEMINI_API_KEY 를 써요.

API 키는 어떻게 보관해야 하나요?

구글 키 안내는 키를 깃(Git)에 올리지 말고 웹·앱 코드에 박지 말라고 해요. 환경변수 GEMINI_API_KEY 에 넣고 서버에서만 불러요. 구글은 아무 제한도 없는 일반 키 요청을 거절하고 있어요.

선불로 충전한 크레딧은 언제까지 쓸 수 있나요?

구글 결제 안내 기준으로 사고 나서 12개월이 지나면 사라지고 돌려받지 못해요. 잔액이 0원이 되면 그 결제 계정의 모든 키가 함께 멈추고 402 오류가 나요. 자동 충전을 켤 때는 한 달 상한도 같이 걸어 두세요.

제미나이 API 가격이 오르나요?

구글 공식 가격표에 따르면 제미나이 3.8 Flash 유료 가격은 2027년 1월 1일부터 입력 1.50달러, 출력 7.50달러로 두 배가 돼요.

생각 토큰도 돈을 내나요?

네. 구글 가격표에 출력 가격은 생각 토큰을 포함한다고 적혀 있어요. 우리 시험에서 기본 설정의 출력 중 약 89%가 생각이었어요.

생각을 낮추는 방법은요?

OpenAI 방식 코드에서는 reasoning_effort='low', 구글 공식 SDK 에서는 thinking_level 을 low 로 주면 돼요.

이 글의 숫자는 어디서 왔나요?