제미나이 API 쓰는 법 — 생각을 낮추면 8배 싸져요(직접 해 봤어요)

제미나이 API 로 짧은 글 요약을 시켜 봤어요. 답은 두 문장, 70토큰쯤이었어요. 그런데 청구된 출력은 710토큰이었어요. 나머지 635토큰은 AI 가 답하기 전에 혼자 생각한 양이었어요. 설정 한 줄로 생각을 낮췄더니 같은 품질의 요약이 8배 싸고 2.7배 빨라졌어요. 제미나이 API 를 처음 쓰는 방법부터 이 설정까지 직접 해 본 순서대로 정리했어요.

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

세 단계예요. 구글 AI Studio 에 들어가 API 키를 받고, 코드에 키를 넣고, 모델 이름을 적으면 돼요. 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)

구글 공식 SDK 를 쓸 때는 설정 이름이 thinking_level 이에요. 제미나이 3.8 Flash 는 기본값이 medium(보통)이고, low·medium·high 를 고를 수 있어요.

무료로 쓰면 뭐가 달라요?

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

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

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

생각 답

기본 설정에서는 출력 710토큰 중 635토큰(89%)이 생각이었어요. 답 자체는 70토큰 안팎이에요.

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

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

그래서 한 번에 얼마예요?

기본 설정 생각 낮춤

생각을 낮추면 8배 싸요. 1월부터 값이 두 배가 돼도 생각을 낮춘 쪽이 지금 기본 설정보다 4배 싸요.

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

자주 묻는 질문

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

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

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

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

생각 토큰도 돈을 내나요?

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

생각을 낮추는 방법은요?

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

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