Google: Gemini 3.1 Pro Preview

에이전트 기반 코딩 및 복잡한 문제 해결을 위한 추론 중심의 Gemini 프리뷰 모델

gemini-3.1-pro-preview

사용 가능Google채팅입력 캐싱 시 90% 할인

입력 / 출력-50%: $2.00 / $12.00$1.00 / $6.00
컨텍스트: 1M
최대 출력: 64K
모달리티: 비전채팅
기능: 도구 사용프롬프트 캐시추론

Gemini 3.1 Pro Preview 소개

Gemini 3.1 Pro는 Gemini 3.1 라인업에서 추론을 우선시하는 Google의 Pro 모델로, 현재 프리뷰 버전으로 제공됩니다. Google은 이 모델이 고급 지능, 복잡한 문제 해결, 강력한 에이전트 기능을 갖추고 있다고 설명합니다. 텍스트와 이미지를 읽고, 답변하기 전에 사고하며, 도구를 호출하고, 스키마가 지정된 JSON을 반환하며, 캐싱을 지원합니다. Flash 모델의 답변이 어려운 작업에서 충분하지 않을 때 선택하는 모델입니다.

강점

내장된 사고(thinking) 기능은 잘못된 첫 답변이 큰 비용을 초래할 수 있는 다단계 문제, 디버깅 및 계획 수립에 적합합니다.
에이전트 기반 코딩에 중점을 두고 있으며, 편집 및 테스트 루프를 위한 도구 호출 기능을 제공합니다.
다이어그램, 차트 및 UI 분석을 위해 이미지와 텍스트를 하나의 프롬프트로 결합할 수 있습니다.
스키마가 지정된 JSON 출력과 캐싱 지원은 프로덕션 파이프라인에 적합합니다.

다른 모델이 필요한 경우

프리뷰 버전이므로 Google이 동작을 변경하거나 안정적인 Pro 릴리스를 위해 서비스를 종료할 수 있습니다.
단순하고 대량의 호출이 필요한 경우, Flash 및 Flash-Lite 모델이 더 빠르게 답변하며 더 적합합니다.

시작하기

API 키 만들기
Console에서 키를 만들고 플랫폼의 모든 모델에 사용하세요.
02
첫 번째 요청 보내기
사용 중인 언어의 예시를 복사하여 엔드포인트에 실행하세요.
텍스트-텍스트Gemini API
POST/v1beta/models/gemini-3.1-pro-preview:generateContent
API 형식:
```
curl "https://api.tokenlab.sh/v1beta/models/gemini-3.1-pro-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: sk-xxx" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "Hello!"}]}
    ]
  }'
```

가격 책정

Verified 가격은 Verified에 적용되며 대부분의 모델에서 더 저렴합니다. Official 가격은 모델 제조사가 공개한 가격으로, 더 안정적인 Official 경로에 적용됩니다. Auto는 요청을 완료한 경로의 가격으로 청구합니다.

입력 토큰 <= 200K · 입력 토큰 범위 · <=200k

1M Token 당

Official 가격: 입력 $2.00 / 출력 $12.00 / 캐시 읽기 $0.20
Verified 가격: 입력 $1.00 / 출력 $6.00 / 캐시 읽기 $0.10
할인: -50%

입력 토큰 > 200K · 입력 토큰 범위 · >200k

1M Token 당

Official 가격: 입력 $4.00 / 출력 $18.00 / 캐시 읽기 $0.40
Verified 가격: 입력 $2.00 / 출력 $9.00 / 캐시 읽기 $0.20
할인: -50%

프롬프트 캐시 가격

캐시 읽기

Official 가격: $0.20
Verified 가격: $0.10
할인: -50%

도구 사용료

모델이 도구를 사용할 때만 호출당 비용이 부과됩니다.

웹 검색

Official 가격: $0.014/검색
Verified 가격: $0.007/검색
할인: -50%

	Official 가격1M Token 당	Verified 가격1M Token 당	할인
입력 토큰 <= 200K · 입력 토큰 범위 · <=200k	입력 $2.00 / 출력 $12.00 / 캐시 읽기 $0.20	입력 $1.00 / 출력 $6.00 / 캐시 읽기 $0.10	-50%
입력 토큰 > 200K · 입력 토큰 범위 · >200k	입력 $4.00 / 출력 $18.00 / 캐시 읽기 $0.40	입력 $2.00 / 출력 $9.00 / 캐시 읽기 $0.20	-50%
프롬프트 캐시 가격
캐시 읽기	$0.20	$0.10	-50%
도구 사용료모델이 도구를 사용할 때만 호출당 비용이 부과됩니다.
웹 검색	$0.014/검색	$0.007/검색	-50%

사용량 및 활동

성공률은 완료된 요청의 비율입니다. 지연 시간은 전체 응답에 걸리는 시간이며, P95는 요청의 95%가 해당 시간 내에 완료되었음을 의미합니다.

사용량 및 가용성

지난 24시간

요청
성공률
P95 지연 시간
총 토큰

모델 성능

마지막 업데이트: 2026. 10. 12. 오후 11:14 UTC

30일 성공률: 99.6%
7일 중앙값 지연시간: 4.9초n=312
7일 P95 지연시간: 32.0초n=312
30일 요청 수: 100+
마지막 활동: 13시간 전

데이터는 상태 확인을 제외한 집계된 사용자 요청을 기반으로 합니다.

Console에서 열기

Console에서 Gemini 3.1 Pro Preview을 열고 프롬프트를 수정하거나 전송하세요.

/v1beta/models/gemini-3.1-pro-preview:generateContent에서 gemini-3.1-pro-preview로 짧은 메시지를 테스트합니다. 응답, 지연 시간, 비용을 확인하세요.

사용 사례

적합한 용도

추론
비전

심층 디버깅
실패한 빌드 로그와 관련 파일을 제공하고, 근본 원인과 최소한의 수정 사항을 요청하세요.
연구 종합
여러 개의 긴 문서를 결합하여 질문 목록이 포함된 논리적인 비교 자료를 작성하세요.
에이전트 계획 수립
작업을 분할하고 각 단계를 더 저렴한 모델에 전달하는 플래너로 사용하세요.
시각적 분석
대시보드 스크린샷이나 아키텍처 다이어그램을 읽고 그 의미를 설명하세요.

프롬프트 예제

이 스택 트레이스는 부하가 걸릴 때만 나타납니다. 관련된 두 모듈이 첨부되어 있으니, 가장 가능성 높은 레이스 컨디션을 찾아 수정안을 제안하세요.

세 가지 공급업체 제안서를 위험, 비용 구조, 종속성 측면에서 비교하고 이유와 함께 하나를 추천하세요.

이 아키텍처 다이어그램을 보고 단일 장애 지점을 나열하세요.

이 모델은 조건부 요금제입니다. 월간 토큰 총량만으로는 신뢰할 수 있는 견적을 낼 수 없습니다. 요청 사양, 캐시, 해당 시간대에 맞는 상세 요금을 사용하세요.

FAQ

Gemini 3.1 Pro는 어떤 점이 뛰어난가요?

복잡한 추론, 에이전트 기반 코딩, 텍스트와 이미지 전반에 걸친 분석에 능합니다. Google은 이를 고급 문제 해결을 위한 모델로 설명합니다. 어려운 작업에는 사고 중심 설정을 사용하고, 일상적인 작업에는 더 저렴한 모델을 사용하세요.

Gemini 3.1 Pro는 안정적인가요?

아니요. Google은 이를 프리뷰로 분류하고 있으며, 이는 동작이 변경되거나 모델이 교체될 수 있음을 의미합니다. 변경 사항을 감지할 수 있도록 평가 세트를 유지하세요.

도구를 호출하고 JSON을 반환하나요?

네. 함수 호출과 스키마 제약이 있는 출력을 모두 지원하며, 이는 자동화된 에이전트 파이프라인에서 플래너나 검토자로 활용할 수 있게 합니다.

언제 3.8 Flash를 선택해야 하나요?

추론의 깊이보다 응답 속도가 더 중요할 때입니다. 3.8 Flash는 Google이 장기 실행 소프트웨어 작업을 위해 설계한 Flash 계열 모델입니다. 가장 어려운 실제 프롬프트로 두 모델을 비교해 보세요.

Gemini 3.1 Pro Preview 의 가격은 얼마인가요?

TokenLab 에서 Gemini 3.1 Pro Preview 은 입력 $1.00 / 출력 $6.00 1M Token 당 입니다. 자세한 내역은 위 가격 표를 확인하세요. 요금은 청구 단위, 사양, 사용량에 따라 달라집니다. 모델의 상세 요금에서 동일한 조건끼리 비교하세요. 단일 요금으로 총비용이 결정되지 않습니다.

Gemini 3.1 Pro Preview의 컨텍스트 윈도우와 출력 제한은 어떻게 되나요?

Gemini 3.1 Pro Preview은 최대 1,048,576 토큰의 컨텍스트를 지원하며, 한 번의 응답으로 최대 65,536 토큰까지 출력합니다.

Gemini 3.1 Pro Preview 은 어떤 엔드포인트를 써야 하나요?

Gemini 3.1 Pro Preview에 대해 https://api.tokenlab.sh/v1beta/models/gemini-3.1-pro-preview:generateContent를 사용하세요. 아래 요청 예시는 일치하는 코드 형태를 보여줍니다.

Gemini 3.1 Pro Preview 은 어떤 오퍼레이션을 지원하나요?

Gemini 3.1 Pro Preview은(는) 텍스트-텍스트을(를) 지원합니다. 엔드포인트와 요청 예시를 보려면 위에서 작업을 선택하세요.