본문으로 건너뛰기

Gemini 3.1 Pro API 가격·설정·제한·마이그레이션 가이드: 무료 API 없음

2026년 10월 10일 기준 Gemini 3.1 Pro API는 Preview이며 무료 등급이 없습니다. 입력 $2·출력 $12(200k 이하)이고 Batch·Flex는 절반입니다.

LaoZhang AI Team게시업데이트 13 분 소요
목차
설정과 모델 선택, 비용 및 마이그레이션을 연결한 Gemini 3.1 Pro API 가이드

2026년 10월 10일 기준으로 Gemini 3.1 Pro API의 model ID는 여전히 gemini-3.1-pro-preview이고, 상태는 정식 출시(GA)가 아닌 Preview입니다. Google 지원 중단 일정 페이지에는 2026년 2월 19일 출시, "지원 종료일 미발표"로 올라 있고 후속 Pro 모델도 없습니다. Gemini API 모델 목록에 3.6 Pro, 3.8 Pro, Gemini 4 같은 이름은 없습니다. 가격은 1M tokens당 입력 $2.00·출력 $12.00(프롬프트 200k 이하)이며, Gemini API에는 이 모델의 무료 등급이 없습니다. 예전 gemini-3-pro-preview는 2026년 3월 9일에 종료됐습니다.

가볍거나 대량으로 돌리는 작업이라면 Pro보다 Gemini 3.8 Flash나 3.6 Flash가 먼저 검토 대상입니다. 두 Flash 모델은 정식 출시 상태이고, 무료 등급이 있으며, 2026년 12월 31일까지 단가가 입력 $0.75·출력 $3.75입니다. 2027년 1월 1일부터는 $1.50·$7.50으로 오릅니다.

기존 코드에서 gemini-3-pro-preview를 쓰고 있었다면 Gemini 3.1 Pro vs Gemini 3 Pro: 무엇이 바뀌었고 지금은 무엇을 써야 하나에서 바뀐 점을 함께 확인하세요.

TL;DR

  • 기본 model ID는 gemini-3.1-pro-preview입니다. bash와 직접 등록한 도구를 섞어 쓰는 에이전트라면 gemini-3.1-pro-preview-customtools도 있으며, 가격은 같습니다.
  • Gemini API에는 3.1 Pro 무료 등급이 없습니다. 무료로 API를 시험하려면 3.8 Flash, 3.6 Flash처럼 무료 등급이 있는 모델로 시작해야 합니다.
  • Standard 가격은 200k 이하 입력 $2.00·출력 $12.00, 200k 초과 $4.00·$18.00입니다. Batch와 Flex는 그 절반, Priority는 1.8배입니다.
  • 출력 단가에는 thinking token이 포함됩니다. 3.1 Pro의 thinking 기본값은 high이므로 비용을 잡으려면 low나 medium을 명시합니다.
  • 신규 결제 계정은 선불(Prepay)이 기본이고 최소 충전액은 $5입니다. 잔액이 $0이 되면 연결된 모든 키가 HTTP 402로 멈춥니다.
  • 실제 RPM·TPM·RPD는 공개 표가 없고 AI Studio의 프로젝트별 한도 화면에서 확인합니다.

가장 빠르게 Gemini 3.1 Pro 첫 요청을 띄우는 방법

순서는 단순합니다. Google AI Studio에서 프로젝트를 만들거나 가져오고, 그 프로젝트에 결제 계정을 연결해 선불 크레딧을 충전한 뒤, API key를 만들어 GEMINI_API_KEY 환경 변수에 넣습니다. 3.1 Pro는 무료 등급에서 제공되지 않으므로 결제가 연결되지 않은 프로젝트의 키로는 이 모델을 호출할 수 없습니다.

키 자체는 무료로 만들 수 있습니다. 다만 Gemini API 키 문서에 따르면 2026년 5월 28일 이후 AI Studio에서 새로 만든 키는 서비스 계정에 묶이고 Gemini API로 범위가 제한된 인증 키(auth key)이며, Gemini API는 제한이 없는 일반 키의 요청을 거부합니다. 오래전에 만든 무제한 키가 "Blocked"로 표시된다면 새 키를 발급해야 합니다.

아래는 공식 GenAI SDK의 generateContent 형식에 맞춘 최소 예제입니다. 모델 이름과 thinking 수준을 명시하는 것이 핵심입니다.

python
from google import genai
from google.genai import types

client = genai.Client()  # GEMINI_API_KEY 환경 변수 사용

response = client.models.generate_content(
    model="gemini-3.1-pro-preview",
    contents="Review this API design and list the main tradeoffs.",
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(thinking_level="medium")
    ),
)

print(response.text)
javascript
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: "gemini-3.1-pro-preview",
  contents: "Review this API design and list the main tradeoffs.",
  config: {
    thinkingConfig: {
      thinkingLevel: "medium",
    },
  },
});

console.log(response.text);
bash
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-pro-preview:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [{
      "parts": [{"text": "Review this API design and list the main tradeoffs."}]
    }],
    "generationConfig": {
      "thinkingConfig": {
        "thinkingLevel": "medium"
      }
    }
  }'

예제에는 temperature, top_p, top_k를 넣지 않았습니다. Google은 2026년 7월 21일 변경 로그에서 이 세 샘플링 파라미터를 지원 중단(deprecated)으로 바꿨습니다. 또 Google 문서의 최신 예제는 Interactions API(client.interactions.create, REST POST /v1beta/interactions)를 기준으로 쓰여 있습니다. 여러 턴 대화를 새로 만든다면 서버가 대화 상태를 관리하는 previous_interaction_id 방식이 Google의 권장 방향입니다.

thinking_level을 생략하면 Gemini 3.1 Pro는 high로 동작합니다. 기본값에 맡기면 지연 시간과 출력 token 비용도 가장 높은 쪽에 맡기는 셈입니다.

prompt보다 먼저 골라야 하는 것은 model path입니다

이 단계에서 정할 것은 프롬프트 문구가 아니라 어떤 model ID로 보낼지입니다. 선택지는 세 갈래입니다.

기본은 gemini-3.1-pro-preview입니다. Gemini 3.1 Pro 모델 페이지는 입력 1,048,576 tokens, 출력 65,536 tokens, 입력 형식으로 텍스트·이미지·동영상·오디오·PDF, 출력은 텍스트로 적고 있습니다. Batch API, Flex·Priority 처리, 컨텍스트 캐싱, 코드 실행, function calling, Google 검색·지도 그라운딩, structured outputs, thinking, URL context를 지원합니다. 큰 문서 분석, 멀티모달 추론, 복합 입력에서의 구조화 추출, 도구가 들어가는 에이전트 작업에 맞는 모델입니다.

gemini-3.1-pro-preview-customtools는 별도의 더 비싼 모델이 아니라 같은 가격의 변형입니다. Google 모델 페이지 설명으로는 bash와 직접 등록한 도구(예: view_file, search_code)를 섞어 쓰는 에이전트에서 그 도구를 더 잘 우선 선택하도록 맞춘 엔드포인트이고, 그런 도구가 도움이 되지 않는 작업에서는 품질이 들쭉날쭉할 수 있습니다. 도구 선택이 실제로 문제가 될 때만 고르면 됩니다.

다른 모델 계열이 맞는 경우도 분명합니다. 3.1 Pro는 이미지 생성, 오디오 생성, Live API를 지원하지 않습니다. 이미지 출력이나 실시간 음성이 필요하면 해당 전용 모델로 가야 하고, 대량 텍스트 처리나 비용이 우선이면 3.8 Flash, 3.6 Flash, 3.5 Flash-Lite가 먼저입니다.

Preview라는 점도 운영 판단에 들어갑니다. Google 모델 목록은 Preview 모델이 "더 엄격한 rate limit이 걸릴 수 있고, 최소 2주 전 공지 후 지원 중단된다"고 적고 있습니다. 2026년 10월 10일 현재 3.1 Pro에는 종료 예정일이 없지만, 장기 운영 코드라면 model ID를 설정값으로 빼 두는 편이 안전합니다.

일반 추론, 도구 중심 에이전트, 비용과 속도 우선 작업에 따른 Gemini 모델 경로 선택

Gemini 3.1 Pro API는 무료인가요: API 무료 등급 없음, AI Studio는 별도

API로는 무료가 아닙니다. Gemini API 가격 페이지의 3.1 Pro 행은 무료 등급 열이 모두 "Not available"이고, Google의 Gemini 3 개발자 가이드 FAQ도 "gemini-3.1-pro-preview에는 Gemini API 무료 등급이 없다"고 적습니다. Gemini API에서 무료로 쓸 수 있는 모델과 한도는 Gemini API 무료 사용 한도(Free Tier) 2026: 무료 모델과 실시간 한도 확인에 따로 정리되어 있습니다.

AI Studio 웹 화면은 사정이 조금 다르고, Google 문서끼리도 설명이 엇갈립니다.

  • 같은 Gemini 3 가이드 FAQ는 "Google AI Studio에서 Gemini 3.1 Pro를 무료로 써 볼 수 있다"고 적습니다. 다만 이 페이지에는 현재 "지원 중단되어 삭제될 예정"이라는 안내가 붙어 있습니다.
  • Google AI 요금제 안내는 무료 사용자에게 "기본 한도"를, Google AI Pro 구독자에게 "Gemini Pro 같은 프리미엄 모델 이용"을 내세웁니다. 이 혜택은 AI Studio 웹 화면에서만 적용되고, API 직접 호출은 따로 과금됩니다.
  • 2026년 10월 10일 기준 AI Studio Playground는 무료 계정에서도 "Gemini 3.1 Pro Preview"가 선택된 상태로 열리지만, 화면에 무료 사용량 수치는 없고 사이드바에는 "Upgrade to unlock more — Access higher limits, Pro models" 배너가 보입니다.
  • 3.1 Pro 출시 당일인 2026년 2월 19일, Google AI 개발자 포럼에는 무료 사용자가 "You are out of free generations today" 안내를 받았다는 글이 올라왔습니다. 개별 사용자 보고입니다.

정리하면 AI Studio에서는 무료 계정으로 3.1 Pro를 잠깐 시험해 볼 여지가 있지만, 하루에 몇 번까지인지는 공개되어 있지 않고 Google은 Pro를 유료 요금제 쪽 모델로 안내하고 있습니다. 코드에서 호출하는 순간부터는 유료입니다.

"무료 크레딧으로 충당하면 되지 않나"라는 질문도 자주 나옵니다. Gemini API 결제 문서에 따르면 2026년 3월부터 Gemini API 사용료는 Google Cloud의 $300 무료 체험 크레딧 적용 대상에서 빠졌고, 웰컴 크레딧도 AI Studio 사용료에 쓸 수 없습니다.

가격과 제한은 "그럴듯한 표"보다 실제 운영 기준으로 봐야 합니다

Gemini 3.1 Pro 가격은 프롬프트가 200k tokens를 넘는 순간 단가 구간이 바뀌고, 처리 방식(Standard, Batch, Flex, Priority)에 따라 다시 갈립니다. Google 가격 페이지(2026년 10월 9일 갱신) 기준, 1M tokens당 유료 등급 가격은 다음과 같습니다. gemini-3.1-pro-preview-customtools도 같은 가격입니다.

처리 방식입력 ≤200k / >200k출력(thinking 포함) ≤200k / >200k캐시 입력 ≤200k / >200k
Standard$2.00 / $4.00$12.00 / $18.00$0.20 / $0.40
Batch$1.00 / $2.00$6.00 / $9.00$0.20 / $0.40
Flex$1.00 / $2.00$6.00 / $9.00$0.20 / $0.40
Priority$3.60 / $7.20$21.60 / $32.40$0.36 / $0.72

캐시는 읽기 단가와 별도로 저장 비용이 시간당 1M tokens당 $4.50(Priority는 $8.10) 붙습니다. 큰 지시문이나 참고 자료를 짧은 간격으로 여러 번 재사용할 때만 이득입니다. Google 검색·지도 그라운딩은 Gemini 3 이상 모델이 함께 쓰는 월 5,000건 무료 요청이 있고, 이후 1,000건당 $14입니다. 무료 등급에서는 쓸 수 없습니다.

1M tokens 입력 창이 3.1 Pro의 강점이지만, 긴 컨텍스트를 자주 쓰면 입력·출력 단가가 모두 올라갑니다. 실제 비용을 줄이는 순서는 대체로 이렇습니다.

  1. 평소 프롬프트는 200k 아래로 유지합니다.
  2. 실시간 응답이 필요 없는 작업은 Batch나 Flex로 보내 절반 가격을 받습니다.
  3. 반복해서 보내는 큰 블록에는 캐싱을 씁니다.
  4. thinking 수준을 비용 조절 수단으로 다룹니다.

Gemini 모델 전체의 가격표와 키 발급 절차는 Gemini API 키 발급과 가격·결제: 키는 무료, 3.8 Flash 단가 2027년 2배에 정리되어 있습니다.

Gemini API 선불(Prepay) 결제: $5 최소 충전, 잔액 $0이면 402

신규 사용자의 Gemini API 결제 방식은 선불(Prepay)이 기본입니다. 최소 충전액은 $5, 최대 보유 잔액은 $5,000이고, 사용료는 거의 실시간으로 차감됩니다. 잔액이 $0이 되면 그 결제 계정에 연결된 모든 프로젝트의 API 키가 한꺼번에 멈추고, 요청은 HTTP 402 Payment Required로 실패합니다. 선불 크레딧은 12개월 뒤 만료되고 환불되지 않습니다.

기존 후불(Postpay) 계정은 선불로 옮겨지는 중입니다. 결제 문서는 "계정 안내에 적힌 전환일 전에" 선불로 바꾸고 크레딧을 충전하라고만 적고 있으며, Impress Watch는 Google 안내를 인용해 전환일을 2026년 10월 12일로 보도했습니다. 본인 계정의 안내 메일과 AI Studio 결제 화면의 날짜를 확인하세요. 무료 등급 기능만 쓰는 계정은 조치가 필요 없습니다. 결제 등급별 진단과 전환 절차는 Gemini API 결제 확인: 가격·선불·후불·등급·한도 진단과 선불 전환에서 다룹니다.

Gemini 3.1 Pro rate limit: 공개 표 없음, AI Studio에서 프로젝트별 확인

Gemini API rate limit 문서는 등급별 RPM 표를 싣지 않고 "활성 한도는 AI Studio에서 확인하라"고 안내합니다. 운영 규칙으로 확인되는 것은 다음과 같습니다.

  • 한도는 RPM, TPM, RPD로 평가되고 API 키가 아니라 프로젝트 단위로 적용됩니다.
  • 사용 등급은 결제 계정 단위입니다. Tier 1은 결제 계정 연결로 시작하고 월 상한 $250, Tier 2는 누적 $100 결제 후 3일 경과 시 월 $2,000, Tier 3는 누적 $1,000 결제 후 30일 경과 시 월 $20,000~$100,000 이상입니다.
  • 월 상한에 닿으면 연결된 모든 프로젝트가 다음 결제 주기까지 멈춥니다. 별도로 10분 단위 지출 한도(Tier 1 $10, Tier 2 $50, Tier 3 $200)를 넘으면 429 RESOURCE_EXHAUSTED가 납니다.
  • Preview 모델인 3.1 Pro는 더 엄격한 한도가 걸릴 수 있습니다.
  • AI Studio의 프로젝트별 지출 상한(spend cap)은 Google이 "실험적이고 범위가 제한된" 기능으로 설명합니다. 예산 보호용으로 켜 둘 수는 있지만 유일한 안전장치로 믿기는 어렵습니다.

429 대응과 등급별 상한은 Gemini API 사용량 한도 2026: 프로젝트 단위 집계와 티어별 상한, 429 대처를 참고하세요. 한국은 Gemini API 이용 가능 지역 목록에 포함되어 있습니다. 중국 본토, 홍콩, 러시아는 목록에 없습니다.

입력 길이, Batch, 캐시와 추론 설정, AI Studio 프로젝트 제한의 네 가지 운영 점검 항목

Gemini 3.1 Pro vs 3.6 Flash·3.8 Flash 가격: 2026년 말까지 약 3배 차이

Gemini 3.1 Pro와 Flash 계열을 비교할 때 지금 기준이 되는 Flash는 3.8 Flash와 3.6 Flash입니다. 3.8 Flash는 2026년 9월 2일, 3.6 Flash는 2026년 7월 21일 정식 출시됐습니다. 예전 이름인 gemini-3.5-flash는 2026년 10월 8일부터 gemini-3.6-flash로, gemini-3.7-flash는 gemini-3.8-flash로 요청이 넘어갑니다. 그래서 "3.1 Pro vs 3.5 Flash"를 찾고 있다면 실제 비교 대상은 3.6 Flash입니다.

1M tokens당 Standard 가격(3.1 Pro는 200k 이하 구간)입니다.

모델상태무료 등급입력출력Batch·Flex 입력/출력
Gemini 3.1 Pro (gemini-3.1-pro-preview)Preview없음$2.00$12.00$1.00 / $6.00
3.8 Flash·3.6 Flash, 2026-12-31까지정식 출시있음$0.75$3.75$0.375 / $1.875
3.8 Flash·3.6 Flash, 2027-01-01부터정식 출시있음$1.50$7.50$0.75 / $3.75

배율로 보면 2026년 말까지 3.1 Pro는 입력이 2.67배($2.00 ÷ $0.75), 출력이 3.2배($12.00 ÷ $3.75)입니다. 2027년 1월 1일 Flash 가격이 오르면 1.33배($2.00 ÷ $1.50), 1.6배($12.00 ÷ $7.50)로 좁혀집니다.

요청 하나에 입력 20,000 tokens, 출력(thinking 포함) 2,000 tokens를 쓴다고 가정하면 다음과 같습니다.

  • 3.1 Pro: 20,000 × $2.00 / 1M + 2,000 × $12.00 / 1M = $0.040 + $0.024 = $0.064
  • 3.8 Flash, 2026년: 20,000 × $0.75 / 1M + 2,000 × $3.75 / 1M = $0.015 + $0.0075 = $0.0225
  • 3.8 Flash, 2027년: $0.030 + $0.015 = $0.045

다만 같은 작업에서 모델마다 thinking token 양이 다릅니다. Google은 3.8 Flash가 "길고 복잡한 작업에서 설계상 더 많은 token을 쓸 수 있다"며, 일상 작업에는 추론 수준을 낮추거나 3.6 Flash를 쓰라고 안내합니다. 실제 비용은 대표 프롬프트로 출력 token을 재 본 뒤 계산해야 합니다.

성능 면에서 Google은 3.8 Flash를 "가장 지능적인 Flash 모델, 장기 소프트웨어 엔지니어링·자율 에이전트·복잡한 업무 흐름용"으로, 3.1 Pro를 "소프트웨어 엔지니어링과 정밀한 도구 사용이 필요한 에이전트 작업에 최적화"된 모델로 소개합니다. 3.8 Flash와 3.1 Pro를 같은 조건으로 비교한 Google 공식 벤치마크 표는 공개되어 있지 않고, 제3자 비교는 서로 결론이 엇갈립니다.

thinking, 긴 컨텍스트, 캐시를 방치하면 비용이 커집니다

3.1 Pro의 thinking 수준은 low, medium, high 세 가지이고 기본값은 high(동적)입니다. minimal은 3.1 Pro에서 지원되지 않습니다(3.1 Flash-Lite와 3 Flash에서는 지원). 3.8 Flash는 기본값이 medium이며 minimal을 넣으면 오류가 납니다. 예전 파라미터 thinking_budget은 하위 호환을 위해 남아 있지만, 한 요청에 thinking_level과 thinking_budget을 함께 넣으면 400 오류가 납니다.

출력 단가에 thinking token이 포함되므로 thinking 수준이 곧 비용 수준입니다. 일상 작업은 medium에서 시작하고, 추출·분류·짧은 변환처럼 깊은 추론이 필요 없는 작업은 low, 큰 코드베이스 리뷰나 여러 단계 분석처럼 Pro를 쓰는 이유가 분명한 작업만 high를 명시하는 방식이 다루기 쉽습니다. 이것은 Google 문서의 문장이 아니라 위 가격 구조에서 나온 운영 판단입니다.

긴 컨텍스트도 같습니다. 1M token이 들어간다는 사실보다 "200k 초과 단가를 얼마나 자주 낼 것인가"와 "어떤 부분을 캐시하거나 요약할 수 있는가"가 중요합니다. 매번 같은 거대한 system prompt, 문서 묶음, 저장소 컨텍스트를 다시 보내는 구현이 가장 비쌉니다.

thinking을 쓰는 여러 턴 대화에서는 thought signature도 챙겨야 합니다. Gemini 3 모델은 API 호출 사이에 추론 맥락을 이어 가기 위해 thought signature를 씁니다. Interactions API의 previous_interaction_id처럼 서버가 상태를 관리하면 신경 쓸 일이 없지만, 대화 기록을 직접 관리한다면 이전 응답의 thought 블록을 signature와 함께 다음 요청에 그대로 넣어야 합니다.

Gemini 3 Pro Preview 또는 OpenAI SDK에서 넘어온다면

gemini-3-pro-preview는 2026년 3월 9일에 종료됐고, Google은 대체 모델로 gemini-3.1-pro-preview를 지정했습니다. 2.5 Pro의 예전 Preview 버전(03-25, 05-06, 06-05)도 같은 모델을 대체 대상으로 가리킵니다. 코드에 남아 있는 예전 이름은 지금 바꾸는 것이 맞습니다.

Google의 마이그레이션 체크리스트를 3.1 Pro 기준으로 옮기면 다음과 같습니다.

  1. model string을 gemini-3.1-pro-preview로 바꿉니다.
  2. thinking_budget을 문자열 값인 thinking_level(low/medium/high)로 바꾸고, 두 파라미터를 함께 남기지 않습니다.
  3. temperature, top_p, top_k, candidate_count, 그리고 모델 턴을 미리 채워 넣는 prefill을 제거합니다. candidate_count는 Gemini 3부터 지원되지 않습니다. 기존 Gemini 3 가이드는 temperature를 1.0 아래로 내리면 반복 출력 같은 예상 밖 동작이 생길 수 있다고 경고했습니다.
  4. 여러 턴 대화는 서버 측 previous_interaction_id로 통일하거나, 직접 관리한다면 thought signature를 보존합니다.
  5. generateContent를 계속 쓴다면 모든 FunctionResponse에 call_id와 name을 넣습니다.
  6. 대표 프롬프트를 다시 돌려 출력 token과 비용을 새 가격으로 계산합니다.

이미 OpenAI SDK를 쓰는 팀이라면 Google의 OpenAI 호환 엔드포인트가 가장 마찰이 적습니다. API key, base URL, model name만 바꾸면 되고, OpenAI의 reasoning_effort 값은 Gemini의 thinking_level로 자동 대응됩니다.

python
from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

response = client.chat.completions.create(
    model="gemini-3.1-pro-preview",
    reasoning_effort="medium",
    messages=[
        {"role": "user", "content": "Summarize the migration risks in this API design."}
    ]
)

print(response.choices[0].message.content)

3.1 Pro는 minimal을 지원하지 않으므로 reasoning_effort도 low, medium, high 중에서 고르는 편이 안전합니다. OpenAI 호환 경로에서 reasoning_effort를 쓰고 있다면 Gemini 고유의 thinking 설정을 따로 겹쳐 넣지 마세요.

laozhang.ai는 2026년 10월 10일 기준 gemini-3.1-pro-preview를 1M tokens당 입력 $2.00·출력 $12.00으로 올려 두고 OpenAI 호환 base URL https://api.laozhang.ai/v1을 제공하는데, Google 키가 아닌 이 플랫폼의 키와 잔액으로 쓰는 별도 계약입니다.

안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.

언제 Gemini 3.1 Pro를 쓰고, 언제 다른 길을 택해야 하는가

3.1 Pro가 맞는 경우는 강한 추론, 긴 컨텍스트, 도구를 쓰는 멀티모달 입력이 한꺼번에 필요하고, Preview 상태와 더 엄격할 수 있는 한도를 감수할 수 있을 때입니다. 작업별로 정리하면 이렇습니다.

작업먼저 고를 모델이유
큰 코드베이스 리뷰, 여러 단계 분석, 복합 문서의 구조화 추출gemini-3.1-pro-preview (high)Pro를 쓰는 이유가 분명한 작업
bash와 직접 등록한 도구를 섞는 에이전트gemini-3.1-pro-preview-customtools같은 가격, 도구 우선 선택에 맞춘 변형
장기 에이전트·소프트웨어 작업인데 비용도 중요gemini-3.8-flash2026년 말까지 단가가 Pro의 약 3분의 1, 무료 등급으로 먼저 시험 가능
분류·요약·대량 텍스트 처리gemini-3.6-flash 또는 3.5 Flash-Lite3.8 Flash보다 token을 덜 쓰는 일상 작업용
실시간 응답이 필요 없는 대량 작업위 모델의 Batch·FlexStandard의 절반
이미지 생성, 실시간 음성이미지·Live 전용 모델3.1 Pro는 지원하지 않음
무료로 API부터 시험3.8 Flash, 3.6 Flash 등 무료 등급 모델3.1 Pro는 무료 등급 없음

Flash 가격이 2027년 1월 1일에 두 배로 오르면 Pro와의 차이는 입력 1.33배, 출력 1.6배로 줄어듭니다. 지금 Flash로 비용을 맞춘 파이프라인이라면 그 날짜 전에 비용 계산을 다시 해 두는 것이 좋습니다.

FAQ

Gemini 3.1 Pro API는 무료인가요?
API로는 무료가 아닙니다. 2026년 10월 10일 기준 Google 가격 페이지에서 Gemini 3.1 Pro Preview의 무료 등급은 "Not available"입니다. AI Studio 웹 화면에서는 무료 계정으로 시험해 볼 여지가 있지만 하루 한도는 공개되어 있지 않고, Google은 Pro를 유료 요금제 쪽 모델로 안내합니다.

gemini-3-pro-preview는 아직 동작하나요?
아닙니다. 2026년 3월 9일에 종료됐고, Google이 지정한 대체 모델은 gemini-3.1-pro-preview입니다. 코드의 model string을 바꾸고 thinking 설정과 샘플링 파라미터를 함께 정리하세요.

Gemini 3.1 Pro Preview는 언제 정식 출시되거나 종료되나요?
2026년 10월 10일 기준 Google은 정식 출시일도 종료일도 발표하지 않았고, 후속 Pro 모델도 없습니다. Preview 모델은 최소 2주 전 공지 후 지원 중단된다는 것이 Google의 규칙입니다.

Gemini 3.1 Pro Preview vs 3.5 Flash, 지금은 어떻게 비교하나요?
gemini-3.5-flash는 2026년 10월 8일부터 gemini-3.6-flash로 요청이 넘어가므로 실제 비교 대상은 3.6 Flash입니다. 3.6 Flash와 3.8 Flash는 2026년 12월 31일까지 입력 $0.75·출력 $3.75이고, 3.1 Pro($2.00·$12.00)의 단가는 그보다 입력 2.67배, 출력 3.2배 높습니다.

Gemini 3.1 Pro와 3.6 Flash 중 무엇을 써야 하나요?
분류, 요약, 대량 처리처럼 깊은 추론이 필요 없는 작업은 3.6 Flash가 맞습니다. 큰 코드베이스나 복합 문서를 다루는 여러 단계 분석에서 Flash 결과가 부족할 때 3.1 Pro로 올리는 순서가 비용 면에서 합리적입니다.

모든 프로젝트에서 gemini-3.1-pro-preview-customtools를 써야 하나요?
아닙니다. 직접 등록한 도구의 우선 선택이 실제 문제일 때만 씁니다. Google은 그런 도구가 도움이 되지 않는 작업에서는 품질 변동이 생길 수 있다고 설명합니다. 가격은 기본 모델과 같습니다.

내 실제 RPM, TPM, RPD는 어디서 보나요?
AI Studio의 rate limit 화면입니다. Google은 등급별 공개 수치를 싣지 않고, 한도는 프로젝트 단위로 적용됩니다.

OpenAI SDK로 Gemini 3.1 Pro를 부를 수 있나요?
가능합니다. API key, base URL(https://generativelanguage.googleapis.com/v1beta/openai/), model name을 바꾸면 되고, reasoning_effort는 Gemini의 thinking_level로 대응됩니다.

Gemini 3.1 Pro는 이미지 생성이나 Live API를 지원하나요?
지원하지 않습니다. 모델 페이지에서 이미지 생성, 오디오 생성, Live API는 "Not supported"입니다.

참고 자료7

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

  1. 1.지원 중단 일정 페이지ai.google.dev/gemini-api/docs/deprecations
  2. 2.Gemini API 키 문서ai.google.dev/gemini-api/docs/api-key
  3. 3.Gemini 3.1 Pro 모델 페이지ai.google.dev/gemini-api/docs/models/gemini-3.1-pro-preview
  4. 4.Gemini API 가격 페이지ai.google.dev/gemini-api/docs/pricing
  5. 5.Google AI 요금제 안내ai.google.dev/gemini-api/docs/google-ai-plans
  6. 6.Gemini API 결제 문서ai.google.dev/gemini-api/docs/billing
  7. 7.Gemini API rate limit 문서ai.google.dev/gemini-api/docs/rate-limits