Gemini 3.1 Pro — 코드와 문서를 논리적으로 분석
Gemini 3.1 Pro는 텍스트, 이미지, 오디오, 동영상, PDF를 하나의 대화에서 다룹니다. 사고 수준을 선택하고 구조화된 텍스트를 요청하며, 애플리케이션에서 도구를 호출할 때는 원본 대화 파트를 보존하세요. US$1.00 / 1M 입력 · US$6.00 / 1M 출력.
- 100만 토큰 입력
- 65,536 토큰 출력
- 세 가지 사고 수준
- 함수 호출
- 멀티모달 입력
Playground
네이티브 요청으로 Gemini 3.1 Pro를 살펴보세요. 계정 그룹을 선택하고 설정을 확인한 후 잔액을 사용해 전송합니다. 실제 기능 검증은 아직 완료되지 않았습니다.
gemini-3.1-pro-preview$1.00 입력 · $6.00 출력, 100만 토큰당추가 Gemini 매개변수
Gemini 3.1 Pro 요금
아래 Gemini 3.1 Pro 요금은 현재 과금 설정을 반영합니다. 사용 가능한 계정 그룹별 입력, 출력, 캐시 입력 요율을 비교하세요. 비캐시 입력이 200,000 토큰을 초과하는 요청에는 긴 컨텍스트 요금 구간이 적용됩니다.
예시 크기는 설명용입니다. 과금은 각 요청이 보고하는 토큰을 따릅니다. Standard 처리 요율입니다. 200,000 토큰 경계는 비캐시 입력을 기준으로 판단합니다. 캐시 토큰은 별도 과금되며 비캐시 입력으로 다시 과금되지 않습니다. 도구 요금과 캐시 저장 비용은 이 토큰 예시와 별도입니다.
| 카테고리 | googlellm-vertext · 비캐시 입력 토큰 ≤ 200,000가격 · 100만 토큰 | googlellm-vertext · 비캐시 입력 토큰 > 200,000가격 · 100만 토큰 | googlellm · 비캐시 입력 토큰 ≤ 200,000가격 · 100만 토큰 | googlellm · 비캐시 입력 토큰 > 200,000가격 · 100만 토큰 |
|---|---|---|---|---|
| 입력 | $1.00 | $2.00 | $0.80 | $1.60 |
| 출력(사고 포함) | $6.00 | $9.00 | $4.80 | $7.20 |
| 캐시 입력 | $0.10 | $0.20 | $0.08 | $0.16 |
요금 구간은 비캐시 입력만으로 결정됩니다. 캐시 입력은 해당 구간의 요율로 별도 과금됩니다. 예시는 표준 요금 구간을 사용합니다.
Gemini 3.1 Pro란 무엇인가요?
Gemini 3.1 Pro는 코드 이해, 문서 비교, 여러 미디어의 정보 설명을 위한 Google 추론 모델입니다. 자료, 질문, 원하는 답변 형식을 함께 제공하세요.
일반 Gemini 3.1 Pro에는 gemini-3.1-pro-preview를 사용합니다. Google은 도구 선택에 특화된 customtools 변형도 문서에 안내합니다. 이 페이지는 일반 버전을 연결하며, 사고 깊이는 별도 설정입니다.
공식 모델 한도는 2026년 10월 17일에 확인했습니다. 입력과 출력에는 각각 별도의 한도가 있습니다.
Gemini 3.1 Pro 시작하기
대표적인 작업부터 시작하세요. 비교할 수 있도록 입력과 설정을 저장합니다.
Playground에서 사용해 보기
Gemini 3.1 Pro 메시지에 참고 자료를 첨부하고 전송 전에 네이티브 JSON 요청을 확인하세요. 공식 컨트롤은 네이티브 필드 이름과 유형을 사용합니다. 사용자 지정 JSON은 변경 없이 전송되며 Gemini API가 검증합니다.
계정 그룹 선택하기
계정에서 사용 가능한 Gemini 3.1 Pro 그룹을 선택하세요. Playground는 선택에 따라 요금을 갱신합니다. 추가 그룹도 동일한 계정별 목록에 표시됩니다.
API 참조 문서 활용하기
네이티브 Gemini 3.1 Pro 예제를 애플리케이션에 복사하세요. 참조 문서는 요청 필드, 응답 필드, 미디어 입력과 아직 실제 확인이 필요한 기능을 안내합니다.
Gemini 3.1 Pro로 만들 수 있는 기능
출력 규약을 정한 다음 결과를 원본 자료와 대조하세요.
변경 사항을 논리적으로 검토하기
Gemini 3.1 Pro에 관련 함수에 걸친 버그 추적, 가정 설명, 범위를 좁힌 패치를 요청하세요. 변경을 수용하기 전에 테스트를 실행합니다.
구조화된 데이터 반환하기
추출이나 분류에 사용할 JSON 응답 스키마를 Gemini 3.1 Pro에 제공하세요. 반환된 값을 문서와 대조합니다. 유효한 JSON이라는 사실만으로 내용이 정확하다고 볼 수는 없습니다.
자체 함수와 연동하기
이름이 있는 함수와 인수 스키마를 선언하세요. Gemini 3.1 Pro는 애플리케이션에서 실행할 함수 호출을 반환할 수 있으며, 허용할 동작은 애플리케이션 코드가 결정합니다.
미디어와 텍스트 비교하기
질문과 함께 차트, 스크린샷 또는 PDF를 제공하세요. Gemini 3.1 Pro는 멀티모달 입력을 받아 텍스트를 반환하므로 제공한 자료에 근거한 설명에 유용합니다.
Gemini 3.1 Pro의 실용적인 작업
권장 워크플로입니다. 벤치마크나 고객 성과를 주장하지 않습니다.
저장소 변경 검토하기
Gemini 3.1 Pro에 관련 파일과 테스트 실패 내용을 제공하세요. 실패를 해결하는 최소한의 변경을 요청하고, 남은 불확실성은 따로 설명하도록 합니다.
문서에서 체크리스트 추출하기
제공한 문서를 구조화된 체크리스트로 바꾸도록 Gemini 3.1 Pro에 요청하세요. 검토자가 각 추출 항목을 확인할 수 있도록 스키마에 출처 위치를 포함합니다.
녹화된 시연 설명하기
지원되는 짧은 동영상을 제공하고 Gemini 3.1 Pro에 특정 단계를 설명하도록 요청하세요. 질문을 눈에 보이는 근거로 한정하고 불분명한 부분도 명시하도록 합니다.
Gemini 3.1 Pro 사용 방법
- 01
사용 준비하기
로그인하고 크레딧을 충전한 후 서버 측 API 키를 만드세요. Playground에서 Gemini 3.1 Pro를 열어 요청 형식을 확인합니다.
- 02
컨텍스트 제공하기
프롬프트와 이전 대화를 contents에 넣으세요. Gemini 3.1 Pro 미디어 입력에는 올바른 MIME 유형과 지원되는 파일 참조를 포함합니다.
- 03
사고와 출력 선택하기
low, medium, high 사고 수준을 사용합니다. Gemini 3.1 Pro의 기본값은 high입니다. 응답 길이가 중요할 때는 maxOutputTokens를 의도적으로 설정하세요.
- 04
응답 확인하기
candidates, finishReason, usageMetadata를 확인하세요. 다음 대화 차례를 전송할 때 Gemini 3.1 Pro의 사고 서명과 도구 파트를 보존합니다.
네이티브 Gemini 3.1 Pro API
Gemini 3.1 Pro는 JSON 응답에 generateContent를, 서버 전송 이벤트에 streamGenerateContent를 사용합니다. 별도의 참조 문서에 복사 가능한 예제와 전체 매개변수 스키마가 있습니다.
정확한 모델 이름 사용하기
URL에 gemini-3.1-pro-preview를 사용하세요. Gemini 3.1 Pro 같은 표시 이름은 API 식별자를 대신할 수 없습니다.
생성 설정 명시하기
Gemini 3.1 Pro에는 temperature와 샘플링 필드가 유지됩니다. Google은 temperature 1.0을 권장합니다. 사고 수준, 출력 형식, 도구는 각각 별도의 컨트롤입니다.
실제 사용량 확인하기
Gemini 3.1 Pro의 출력 사용량에는 사고 토큰이 포함됩니다. 캐시 입력도 컨텍스트 경계값을 판정하는 전체 입력에 포함되며 캐시 입력 요율로 과금됩니다.
두 가지 공식 Gemini 3.1 Pro 변형
차이는 또 다른 추론 수준이 아니라 도구 선택에 있습니다. 이 페이지에는 일반 Gemini 3.1 Pro 모델만 연결되어 있습니다.
| 선택지 | 일반 Preview | Customtools Preview |
|---|---|---|
| API ID | gemini-3.1-pro-preview | gemini-3.1-pro-preview-customtools |
| 문서에 명시된 목적 | 범용 추론과 도구 사용 | bash도 사용할 수 있을 때 맞춤 도구 우선 |
| 함수 호출 | 지원 | 도구 선택에 특화된 동작 |
| 평가 질문 | 실제 작업을 해결하는가? | 의도한 맞춤 도구를 선택하는가? |
Google은 의도한 워크플로 밖에서 Customtools의 품질에 변동이 있을 수 있다고 경고합니다. 이는 문서에 기반한 비교이며 새 A/B 벤치마크가 아닙니다. Google 모델 문서
Gemini 3.1 Pro 제한 사항
입력과 출력 예산 구분하기
Gemini 3.1 Pro는 최대 1,048,576 입력 토큰을 받고 최대 65,536 출력 토큰을 생성합니다. 사고는 출력 예산을 사용하므로 짧은 답변에도 사고 토큰이 필요할 수 있습니다.
텍스트만 출력
Gemini 3.1 Pro는 지원되는 미디어를 분석할 수 있지만 이미지나 오디오를 생성하지 않습니다. 이러한 출력에는 전용 생성 모델을 사용하세요.
고급 기능 확인하기
Gemini 3.1 Pro는 공식 모델 사양에서 도구를 지원합니다. 이 연동의 미디어, 캐싱, 개별 도구에 대한 실제 검증은 아직 진행되지 않았습니다. 매개변수 수락만으로 동작이 입증되는 것은 아닙니다.
캐시 리소스에는 접근 권한 필요
cachedContent 값은 기존 캐시 리소스를 가리킵니다. 이름 형식이 올바르다는 이유만으로 Gemini 3.1 Pro가 캐시를 사용할 수는 없습니다. 리소스 접근 권한과 모델 호환성도 충족해야 합니다.
SeedRouter에서 Gemini 3.1 Pro 사용하기
하나의 계정 잔액
Gemini 3.1 Pro와 목록에 있는 다른 텍스트, 이미지, 동영상 모델에 동일한 SeedRouter 잔액을 사용합니다. 각 모델의 요청 형식과 제약을 준수하세요.
모델 옆에서 요금 확인
이 페이지에서 Gemini 3.1 Pro 토큰 요율을 확인하고 사용할 계정 그룹을 선택하세요. 요금표는 현재 과금 설정을 반영합니다.
성공한 요청에 결제
실패한 Gemini 3.1 Pro 요청에는 요금이 부과되지 않습니다. 성공한 요청은 사고와 캐시 입력을 포함해 보고된 토큰 사용량을 사용합니다.
다른 텍스트 모델 살펴보기
사용 가능한 텍스트 모델의 문서에 명시된 기능과 현재 요금을 비교하세요.
OpenAI SDK로 GPT-6 Astra를 호출하세요. OpenAI의 가장 강력한 모델, 105만 토큰 컨텍스트, 토큰당 실시간 가격, 지금 바로 사용해 볼 수 있는 Playground.
가격 보기GPT-6 Sol을 OpenAI SDK로 호출하세요. 105만 토큰 컨텍스트, none부터 max까지 추론 강도 설정, 실시간 토큰 가격, 바로 써 볼 수 있는 Playground를 제공합니다.
가격 보기OpenAI SDK로 GPT-6.1 Sol을 호출하세요. Astra에 가까운 코딩·에이전트 성능을 5분의 1 가격에, 105만 토큰 컨텍스트, 캐시된 입력 95% 할인. 지금 사용해 보세요.
가격 보기OpenAI SDK로 GPT-6 Luna를 호출하세요. GPT-6 제품군에서 가장 저렴한 모델로, 105만 토큰 컨텍스트와 토큰당 실시간 가격, 바로 써 볼 수 있는 Playground를 제공합니다.
가격 보기Claude Haiku 5.5로 분류, 정보 추출, 요약을 체험합니다. 실시간 토큰 요금을 확인하고 직접 쓴 프롬프트의 답변과 사용량을 검토한 뒤 Messages API로 앱에 연결합니다.
가격 보기Claude Sonnet 5.5로 코드 리뷰와 문서 질문을 처리합니다. 실시간 토큰 요금을 확인하고 프롬프트를 테스트한 뒤, 검증된 기능을 살펴보고 앱에 연결할 수 있습니다.
가격 보기Gemini 3.1 Pro 가이드
애플리케이션 설정을 선택하기 전에 두 공식 모델 ID를 이해하세요.
Gemini 3.1 Pro 자주 묻는 질문
Gemini 3.1 Pro 모델 ID는 무엇을 사용하나요?+
여기서는 Gemini 3.1 Pro에 gemini-3.1-pro-preview를 사용합니다. 별도의 customtools 변형은 bash도 사용할 수 있을 때 맞춤 도구를 우선합니다.
Gemini 3.1 Pro의 기본 사고 수준은 무엇인가요?+
Gemini 3.1 Pro의 기본값은 high입니다. low와 medium은 지원하지만 minimal은 지원하지 않습니다. thinkingLevel과 thinkingBudget을 함께 사용하지 마세요.
Gemini 3.1 Pro는 입력이 200K 토큰을 넘으면 왜 요금이 달라지나요?+
현재 요금은 두 구간으로 나뉘며, 비캐시 입력이 200,000 토큰을 초과하면 더 높은 요금 구간이 적용됩니다. 캐시 입력은 선택된 구간의 캐시 입력 요율로 별도 과금됩니다. 계정 그룹별 요금은 실시간 표를 확인하세요.
Gemini 3.1 Pro로 이미지를 생성할 수 있나요?+
Gemini 3.1 Pro는 지원되는 미디어를 입력받지만 텍스트를 반환합니다. 생성된 이미지가 필요하면 이미지 모델을 사용하세요.
Gemini 3.1 Pro 함수 호출에 Customtools가 필요한가요?+
일반 Gemini 3.1 Pro도 함수 호출을 지원합니다. Customtools는 도구 선택 동작을 바꾸며, 함수를 선언하는 데 필수는 아닙니다.