Gemini 이미지 생성 API는 무료가 아니었어요, 내 키가 유료인지 확인하는 법

Gemini API 키가 있으면 이미지도 무료 한도 안에서 몇 장은 받을 수 있을 것 같죠. 저도 그렇게 짐작하고 테스트했는데, 다시 확인해 보니 테스트 이미지 19장에 약 $0.65가 이미 과금돼 있었어요. 이유는 두 가지예요. Gemini의 이미지 생성 모델에는 무료 티어가 없고, 제 키는 요청한 만큼 돈이 나가는 유료 키였어요.

증상: 이미지가 잘 나오고 429도 안 떠요

8월 20일, 과학 쇼츠를 자동으로 만드는 프로젝트에서 있었던 일이에요. 서버의 로컬 이미지 생성기가 작업을 거절하면 장면 그림이 비어서, 그럴 때만 대신 쓸 곳이 필요했어요. 갖고 있던 Gemini API 키로 이미지 모델 세 가지를 불러 봤더니 전부 그림이 나왔어요. 한 장에 3.7~15.1초였고 9:16 세로 비율도 됐어요. 동시에 8건을 보내도 429(요청 한도 초과) 오류가 없었어요. 그래서 바로 대체 경로로 붙였어요.

붙이고 나서 이게 정말 무료가 맞는지 다시 확인했어요. 텍스트 모델에 150건을 1.9초 안에 보내 봤는데 429가 한 건도 없었어요. 이미지가 잘 나오고 한도에도 안 걸린 것이 무료가 아니라는 신호였어요.

원인: 이미지 생성 모델에는 무료 티어가 없어요

공식 가격표에는 (확인한 날짜 2026-10-03) 모델마다 무료 티어 칸과 유료 티어 칸이 따로 있어요. 텍스트 모델 중에는 무료 티어 칸이 "Free of charge"인 것이 있지만, 아래 표에 적은 이미지 생성 모델 네 가지는 무료 티어 칸이 입력과 출력 모두 "Not available"이에요. 무료 한도가 작은 것이 아니라 아예 없어요.

요금은 그림 장수가 아니라 출력 토큰으로 매겨요. 모델마다 100만 토큰당 가격이 있고, 가격표에는 1K(1024x1024) 그림 한 장이 1,120토큰이라고 적혀 있어요.

무료와 유료는 키가 아니라 프로젝트에 붙어요. 한도 문서에는 (확인한 날짜 2026-10-03) 한도가 API 키가 아니라 프로젝트 단위로 적용된다고 나와 있고, 등급 표에서 Free 다음 단계인 Tier 1의 조건이 "결제 계정을 만들어 연결하는 것"이에요. 결제를 연결해 둔 프로젝트에서 만든 키는 무료 등급이 아니에요.

내 Gemini API 키가 무료 티어인지 확인하는 방법

돈이 들지 않는 방법부터 적을게요.

1. AI Studio의 Projects 페이지 보기. 결제 문서에 따르면 (확인한 날짜 2026-10-03) Projects 페이지의 Billing Tier 열에 프로젝트의 등급과 결제 방식이 나와요. 키가 속한 프로젝트가 Free인지 여기서 바로 보여요.
2. 사용량 보기. 같은 문서에 AI Studio의 Dashboard, Usage에서 사용량을 볼 수 있다고 나와 있어요. 한도 문서에는 지금 적용되는 한도를 AI Studio의 rate limit 화면에서 보라고 돼 있어요.
3. 쓰려는 모델을 가격표에서 찾기. 무료 티어 칸이 "Not available"이면 그 모델은 유료 프로젝트에서만 쓰는 모델이에요.

제가 했던 "한꺼번에 많이 보내 보기"는 권하지 않아요. 150건에 429가 0건이었던 것은 제가 겪은 일이고, 한도는 모델마다 다르고, 한도 문서는 실제 숫자를 AI Studio에서 보라고 안내해요. 그리고 유료 키라면 이 시험 자체가 과금이에요.

응답에 들어 있던 serviceTier 값도 확인 수단으로 쓰지 않는 편이 좋아요. 제 응답에는 standard라고 찍혀 있었고 그때는 이것도 유료 신호로 읽었어요. 그런데 공식 문서에서 service_tier는 요청을 어떤 처리 등급(standard, flex, priority)으로 보낼지 정하는 값이고, 생략하면 standard라고 설명해요. 무료·유료 결제 등급을 알려 주는 값이라는 설명은 찾지 못했어요.

Gemini 이미지 API 장당 가격: 제가 잰 값과 공식 가격표

구분	장당 비용	근거
제가 쟀을 때 (8월 20일, 가장 싼 모델)	$0.0336	장당 1,120토큰
제가 쟀을 때 (9월 6일, 영상 썸네일)	약 $0.165	출력 1,378토큰
공식 가격표 gemini-3.1-flash-lite-image	$0.0336 (1K)	100만 토큰당 $30
공식 가격표 gemini-3.1-flash-image	$0.067 (1K), 해상도에 따라 $0.045~0.151	100만 토큰당 $60
공식 가격표 gemini-3-pro-image	$0.134 (1K·2K), $0.24 (4K)	100만 토큰당 $120
공식 가격표 gemini-2.5-flash-image	$0.039	가격표에 2026년 10월 2일 종료라고 표시돼 있음

공식 값은 2026-10-03에 본 가격표 기준이고, 모델 이름과 가격은 바뀔 수 있어요. 8월에 제가 확인했던 세 모델의 장당 값($0.0336, $0.039, $0.134)은 지금 가격표에도 같은 숫자로 있어요.

썸네일은 달랐어요. 제가 잰 값은 약 $0.165인데 가격표의 장당 환산값에는 그 숫자가 없어요. 1,378토큰에 $0.165면 100만 토큰당 $120꼴이라 단가는 가장 비싼 모델과 같고, 토큰 수가 가격표의 1,120보다 많이 나온 거예요. 왜 더 많이 나왔는지는 확인하지 못했어요. 장당 값은 가격표의 환산값을 믿기보다 실제 응답의 출력 토큰 수로 계산해 보는 게 안전해요.

영상 한 편, 일 년이면 얼마인지

장당 몇 센트라 작아 보이지만 자동으로 계속 도는 작업에 붙이면 금방 쌓여요. 제 숫자로 계산하면 이래요.

쓰임	제가 쟀을 때 비용
쇼츠 한 편(5~6장면)을 전부 Gemini 이미지로	$0.17~0.20
무료인 줄 알고 한 테스트 19장	약 $0.65
영상 썸네일 7장 (9월 6일 밤까지)	약 $1.15
동화책 영상 한 편 (대본 $0.01 + 표지 $0.16 + 본문 7장 $1.12)	$1.29
같은 한 편, 다시 뽑는 여유 포함	약 $1.8
주 2편씩 일 년	약 $187

동화책 영상은 어린이 동화 영상을 자동으로 만드는 프로젝트의 계산이에요. 이 계산을 한 날 삽화를 전부 로컬 모델로 옮겼고, 옮긴 뒤에는 한 편에 4분 20초, 0원이었어요. 썸네일도 Gemini로는 21초에 약 $0.165, 로컬 모델로는 97초에 0원이어서 로컬로 바꿨어요.

모르는 사이에 과금되지 않게 하는 방법

제가 한 것은 두 가지예요. 먼저 유료 대체 경로를 끄는 스위치를 환경변수로 만들었어요. 값이 false면 로컬 생성이 실패해도 Gemini로 넘어가지 않아요.

# 유료 이미지 API로 넘어가는 대체 경로 끄기
GEMINI_IMAGE_FALLBACK=false

그리고 순서를 로컬 먼저, 실패했을 때만 Gemini로 정했어요. 그 뒤 로컬 생성기가 작업을 거절하던 문제를 따로 고쳤고, 스위치를 끈 채로 17장면을 전부 로컬에서 만들었어요. 유료 API 비용은 0원이었어요.

구글 쪽에서 걸 수 있는 장치도 두 가지 확인했어요.

• 프로젝트 지출 상한. 결제 문서에 따르면 AI Studio의 Spend 페이지에서 Monthly spend cap, Edit spend cap으로 프로젝트별 월 상한을 정할 수 있어요. 다만 결제 데이터 반영이 10분쯤 늦을 수 있어서 상한을 조금 넘길 수 있다고 적혀 있어요.
• 예산 알림. Cloud Billing 문서에 따르면 (확인한 날짜 2026-10-03) 결제 메뉴의 Budgets & alerts에서 예산을 만들면 기본으로 예산의 50%, 90%, 100%에서 알림이 와요. 프로젝트 단위로도 걸 수 있어요. 알림만 있는 예산은 사용을 자동으로 멈추지 않는다고 문서에 적혀 있으니, 알림은 알림으로만 생각해야 해요.

테스트만 할 거라면 결제를 연결하지 않은 프로젝트를 따로 만들어 그 키를 쓰는 방법도 있어요. 결제 문서에 유료 프로젝트와 무료 프로젝트를 각각의 키로 오가며 쓸 수 있다고 나와 있어요. 다만 이미지 생성 모델은 가격표에서 무료 티어가 "Not available"이라, 이미지는 어느 쪽이든 유료라고 보고 시작하는 게 맞아요.

한눈에 보기

• Gemini 이미지 생성 모델은 공식 가격표에서 무료 티어가 없어요 (2026-10-03 확인)
• 무료·유료는 키가 아니라 프로젝트에 붙어요. AI Studio의 Projects 페이지, Billing Tier 열에서 확인해요
• 429가 안 뜨고 잘 나오면 무료가 아닐 가능성을 먼저 의심해요
• 장당 비용은 응답의 출력 토큰 수로 계산해요. 제가 쟀을 때 $0.0336에서 약 $0.165까지 나왔어요
• 유료 API를 대체 경로로 붙일 때는 끄는 스위치를 먼저 만들고, 로컬 먼저 시도하게 순서를 정해요