오늘 Gemini Decisions API를 무료로 사용할 수 있습니다. Google의 gemini-decision-1 무료 티어에서는 입력이 무료이고, 출력 토큰 비용은 청구되지 않으며, 프로젝트당 분당 200건의 요청, 분당 50,000개 토큰, 일일 10,000건의 요청이 허용됩니다. AI Studio API 키만 있으면 되고 결제 계정은 필요하지 않습니다. 다만 무료 티어에서는 Google이 콘텐츠를 제품 개선에 사용할 수 있다는 점에 유의하세요.
이 글에서는 실제 워크로드에서 이러한 제한이 의미하는 바, 100만 토큰당 $0.10이라는 유료 가격의 토큰 계산법, 다른 무료 경로들, 그리고 테스트와 CI를 일일 할당량 밖으로 유지하는 방법을 다룹니다. 모든 할당량과 가격은 2026년 11월 12일 기준 Google 공식 페이지에서 확인한 것입니다. API는 v1beta로 제공되므로 예산을 세우기 전에 다시 확인하세요. 질문 유형 자체(noul, choice, score)에 대해서는 Google의 Decisions API 가이드를 참고하세요.
Gemini Decisions API 무료 티어에 포함된 것
Gemini Decisions API 무료 티어는 Google의 Gemini Developer API 중 gemini-decision-1 모델에 적용되는 무료 사용 티어입니다. 각 Google Cloud 프로젝트에 무료 입력 처리, 출력 요청 0원, 그리고 분당 200건의 요청(RPM), 분당 50,000개 토큰(TPM), 일일 10,000건의 요청(RPD)이라는 고정 속도 제한을 제공하며, 결제 설정이 필요 없습니다.
Google의 가격 페이지와 속도 제한 페이지의 내용을 나란히 정리하면 다음과 같습니다:
| 항목 | 무료 티어 | 유료 (Tier 1) |
|---|---|---|
| 입력 가격 (텍스트, 이미지, 동영상, 오디오, PDF) | 무료 | 100만 토큰당 $0.10 |
| 출력 가격 | 해당 없음 (출력 토큰 0개) | 해당 없음 (출력 토큰 0개) |
| 분당 요청 수 | 200 | 1,500 |
| 분당 토큰 수 | 50,000 | 1,000,000 |
| 일일 요청 수 | 10,000 | 50,000 |
| Google 제품 개선에 콘텐츠 사용 | 예 | 아니요 |
| 컨텍스트 캐싱 | 사용 불가 | 사용 불가 |
눈에 띄는 숫자보다 더 중요한 세 가지 세부 사항이 있습니다:
- 제한은 API 키가 아니라 프로젝트 기준입니다. 하나의 프로젝트에서 키를 다섯 개 만든다고 해서 할당량이 다섯 배가 되는 것은 아닙니다.
- 일일 상한은 태평양 표준시 자정에 초기화됩니다. 태평양 시간 기준 오후 11시에 시작하는 배치 작업은 그날의 할당량을 1시간 동안 사용한 뒤, 자정이 지나면 새로운 10,000건을 받게 됩니다.
- 무료 티어 데이터는 Google이 사용할 수 있습니다. 가격 표에서 "제품 개선에 사용" 항목은 무료 티어에서는 "예", 유료에서는 "아니요"로 표시되어 있습니다. 고객 PII, 계약서, 의료 이미지 등은 무료 키로 전송하지 마세요.
무료 Gemini Decisions API 키 발급 방법
약 5분 만에 무료 호출을 시작할 수 있습니다:
- Google AI Studio에 로그인하고 Create API key를 클릭합니다. 새 프로젝트는 무료 티어에서 시작됩니다.
- SDK 3.2 이상을 설치합니다:
pip install -U google-genai또는npm install @google/genai@latest. - 키를
GEMINI_API_KEY로 내보내면 SDK가 자동으로 인식합니다. http_options={"api_version": "v1beta"}로 요청을 한 번 보내고 응답의usage블록을 확인합니다.
from google import genai
client = genai.Client(http_options={"api_version": "v1beta"})
result = client.decisions.create(
model="gemini-decision-1",
input="Order 8821 arrived with a cracked screen.",
questions={
"is_damaged": {"type": "noul", "instructions": "Did the item arrive damaged?"},
},
)
print(result.answers["is_damaged"].noul)
print(result.usage.total_input_tokens)
이때 usage.total_input_tokens 수치를 기록해 두세요. 무료 티어에서는 이 수치가 50,000 TPM을 소모하는 요소이고, 유료에서는 청구되는 유일한 항목입니다.
Google의 다른 무료 제공 내용은 Gemini API 무료 티어 가이드와 Gemini 무료로 사용하는 방법을 참고하세요.
Gemini Decisions API 가격 구조
입력 토큰에 대해서만 비용을 지불하며, 공유 입력은 질문 개수와 상관없이 요청당 한 번만 계산됩니다. 각 질문에는 해당 질문의 지침과 기준 토큰만 추가됩니다. 출력은 모델이 텍스트가 아닌 확률을 반환하기 때문에 항상 0 토큰입니다.
따라서 한 번의 요청에 대한 공식은 간단합니다:
input tokens = shared input + sum(each question's instructions + criteria)
paid cost = input tokens / 1,000,000 x $0.10
흥미로운 점은 이것이 무료 티어에 미치는 영향입니다. 텍스트의 경우 요청 수(분당 200건, 일일 10,000건)가 먼저 제한에 걸리는 경우가 많습니다. 이미지, 오디오 또는 긴 문서의 경우 50,000 TPM 제한이 먼저 걸립니다.
실제 비용 계산 예시: 무료 티어 vs 유료
아래 질문 토큰 수치는 추정치입니다(짧은 질문당 약 30개 토큰). 이미지와 오디오 수치는 Google의 미디어 해상도 표에서 가져온 것으로, 현재 Gemini 모델의 경우 이미지 1장당 low는 280개 토큰, high는 1,120개 토큰, 오디오는 초당 25개 토큰으로 명시되어 있습니다. 실제 요청을 한 번 실행해서 이 수치를 본인의 usage 값으로 대체하세요.
상품 사진 10,000장 × 질문 16개
배송 사진에서 파손, 배치, 라벨 가독성 등 16가지 항목을 확인한다고 가정해 봅시다.
low해상도 기준 요청당: 280 (이미지) + 20 (텍스트 컨텍스트) + 16 × 30 (질문) = 780 토큰- 사진 10,000장: 10,000 × 780 = 780만 토큰
- 유료 비용: 7.8 × $0.10 = $0.78
high해상도 기준: 사진당 1,120 + 20 + 480 = 1,620 토큰, 총 1,620만 토큰, $1.62
무료 티어에서는 TPM이 속도를 결정합니다: 50,000 / 780 = 분당 약 64장. 10,000장 모두를 처리하는 데 약 2시간 36분이 걸리고, 정확히 하루 할당량인 10,000건의 요청을 사용합니다. high 해상도에서는 분당 약 30장, 약 5시간 30분이 걸립니다.
이제 피해야 할 실수를 살펴보겠습니다. 16가지 확인을 16개의 별도 요청으로 보내면 각 요청이 이미지를 다시 전송하게 됩니다: 16 × 300 = 4,800개의 이미지 및 컨텍스트 토큰에 동일한 480개의 질문 토큰을 더해 사진당 약 5,280개 토큰입니다. 이는 5,280만 토큰(유료 $5.28)이자 160,000건의 요청으로, 무료 티어 할당량 16일치에 해당합니다. 질문은 한 번에 묶어서 보내세요.
지원 티켓 10,000건 × 라우팅 질문 3개
- 요청당: 250 (티켓 텍스트) + 3 × 40 (기준이 포함된 질문) = 370 토큰
- 티켓 10,000건: 370만 토큰, 유료 $0.37
- 무료 티어: 50,000 / 370 = 분당 135건으로, 분당 200건 제한 이하입니다. 하루 10,000건의 요청으로 10,000건의 티켓을 모두 처리할 수 있습니다.
긴 PDF
컨텍스트 윈도우는 262,144 토큰이지만 무료 TPM은 50,000이므로, 120,000 토큰짜리 계약서 하나만으로도 무료 예산 1분치를 초과합니다. Google 문서는 TPM 상한을 초과하는 단일 요청을 무료 티어에서 어떻게 처리하는지 설명하지 않으므로, 먼저 하나를 테스트해 보세요. 긴 문서 처리에서야 Tier 1(100만 TPM)이 빛을 발합니다.
Gemini Decision 1을 $0에 사용하는 다른 방법
| 경로 | 비용 | 카드 또는 결제 필요 여부 | 적합한 용도 |
|---|---|---|---|
| Gemini API 무료 티어 (AI Studio 키) | $0, 분당 200건 / 분당 50,000 토큰 / 일일 10,000건 | 아니요 | 프로토타입, 내부 도구, 일일 10,000건 이하의 야간 배치 작업 |
| AI Studio의 Decisions Playground | $0 (Google 출시 공지 기준 무료 티어) | 아니요 | 코드 작성 전 질문 문구 테스트 |
OpenRouter (google/gemini-decision-1) |
입력 100만 토큰당 $0.10, 출력 $0 | 예 (크레딧) | 여러 프로바이더를 하나의 키로 사용; 무료 아님 |
2026년 11월 12일 기준 확인한 OpenRouter의 모델 페이지에서는 프로바이더 한 곳(Google AI Studio)이 입력 100만 토큰당 $0.10, 출력 무료로 등록되어 있으며 :free 변형은 없습니다. OpenRouter의 Decisions 엔드포인트에서 실행되므로 chat completions SDK로는 호출할 수 없습니다.
무료 티어 안에서 유지하는 방법
다음 습관들은 프로토타입을 최대한 오래 $0로 유지하는 데 도움이 됩니다:
- 모든 질문을 한 번의 요청으로 보내세요. 공유 입력은 한 번만 청구되며, 한 번의 호출에 최대 1,000개의 질문을 담을 수 있습니다.
- 미디어 해상도를 낮추세요.
low는 이미지당high의 4분의 1 비용입니다. - 질문에 필요한 필드만 전송하세요. Google은 관련 없는 콘텐츠가 정확도를 떨어뜨린다고 밝히고 있으며, TPM도 소모합니다.
- RPM이 아닌 TPM에 맞춰 조절하세요. 워커 속도를 측정된 요청당 토큰 수로 50,000을 나눈 값에 맞추세요.
- 답변을 직접 캐시하세요. API에는 컨텍스트 캐싱이 없고 반복 입력을 전부 계산하므로, 입력과 질문을 해시화해 중복을 건너뛰세요.
- 대규모 실행은 태평양 표준시 자정 이후에 시작하세요. 하루 치 할당량을 온전히 받을 수 있습니다.
- 테스트와 CI는 실제 API를 사용하지 마세요. 푸시할 때마다 호출하는 테스트 스위트는 점심 무렵이면 10,000건의 요청을 소진할 수 있습니다. 대신 모킹하세요.
Apidog CLI로 코딩 에이전트가 Decisions API를 모킹하게 하기
단위 테스트에는 실제 모델이 필요하지 않습니다. 필요한 것은 올바른 형태입니다: answers 맵, 0.01~0.99 사이의 noul, confidence, 그리고 usage.total_output_tokens: 0입니다. 코딩 에이전트는 Apidog CLI로 이러한 모의 객체를 만들 수 있으므로, 실제 Google에 접근하는 것은 스모크 테스트 하나뿐이면 됩니다.
한 번만 설정하면 됩니다:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
그 다음 Claude Code, Codex 또는 Cursor에 프롬프트 하나를 제공합니다:
In Apidog project <id>, add the Gemini Decisions endpoint POST /v1beta/decisions
with a request body of model, input and questions. Create mock expectations that
return a damaged answer (noul 0.97) and an undamaged one (noul 0.04), each with
usage.total_output_tokens = 0. Add a test case that asserts the answers map,
confidence between 0 and 1 and zero output tokens. Run it against the mock
environment, then once against the real API with my free-tier key.
에이전트는 각 페이로드 스키마를 읽고 검증한 뒤에야 다음을 작성합니다:
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file decisions-endpoint.json
apidog endpoint create --project <id> --file decisions-endpoint.json
apidog cli-schema get mock-create
apidog cli-schema validate mock-create --file mock-damaged.json
apidog mock create --project <id> --file mock-damaged.json
apidog cli-schema get test-case-create
apidog test-case create --project <id> --file decisions-case.json
apidog run --test-case <caseId> --project <id> -e <mockEnvId> -r cli,json
apidog run --test-case <caseId> --project <id> -e <freeTierEnvId> -r cli
CI에서는 -r junit으로 모의 환경만 실행하세요(파이프라인 파일은 Apidog CLI CI/CD 가이드에 있음); 에이전트 설정은 Claude Code에서의 Apidog CLI에 있습니다. Apidog의 Free 플랜은 최대 4명까지 지원하므로 소규모 팀은 비용 없이 모의 객체를 공유할 수 있습니다. OpenAI 버전도 고려 중인가요? OpenAI Decisions API 설명서를 참고하세요.
FAQ
Gemini Decisions API는 무료인가요? 네, 제한 내에서 무료입니다. 무료 티어는 입력 비용이 청구되지 않고 출력은 항상 0 토큰입니다. 프로젝트당 분당 200건의 요청, 분당 50,000개 토큰, 일일 10,000건의 요청이 제공됩니다. 이를 초과하려면 결제를 설정하고 입력 토큰 100만 개당 $0.10을 지불하면 됩니다.
Gemini Decisions API 무료 티어에 신용카드가 필요한가요? 아니요. Google AI Studio의 API 키는 무료 티어에서 시작합니다. Google의 속도 제한 페이지에 따르면 AI Studio에서 결제를 설정한 후에야 유료 티어로 전환됩니다.
Google이 무료 티어 Decisions API 데이터로 학습하나요? Google의 가격 페이지는 무료 티어의 경우 "제품 개선에 사용"을 "예", 유료의 경우 "아니요"로 표시합니다. 무료 티어 키는 민감한 데이터에 적합하지 않은 것으로 취급하세요.
분당 200건에 훨씬 못 미치는데 429 오류가 발생하는 이유는? 분당 50,000개 토큰을 초과했을 가능성이 높습니다. 이미지, 오디오, PDF 입력은 토큰 소모가 크기 때문에 일반적으로 RPM보다 TPM이 먼저 걸립니다. usage.total_input_tokens를 기록하고 요청 속도를 해당 수치로 50,000을 나눈 값에 맞추세요.
OpenRouter에 무료 Gemini Decision 1 모델이 있나요? 2026년 11월 12일 기준으로는 없습니다. OpenRouter에는 google/gemini-decision-1이 입력 100만 토큰당 $0.10, 출력 $0로 등록되어 있으며 :free 변형은 없습니다.
Batch API나 컨텍스트 캐싱으로 무료 티어를 늘릴 수 있나요? 아니요. 모델 페이지에 따르면 Batch API와 캐싱은 모든 티어에서 지원되지 않습니다. 질문을 한 번의 요청으로 묶고 답변은 본인 코드에서 캐시하세요.