Gemini 3.1 Pro (Preview) 한눈에
Gemini 3.1 Pro Preview는 Gemini 3 Pro 계열의 성능과 신뢰성을 다듬으려고 만든 미리보기 모델이에요. 더 나은 사고와 사실에 더 충실한 답을 내세우고, 도구를 정확히 다뤄야 하는 여러 단계 에이전트 작업에 맞춰 다듬어졌어요. 구글은 단순한 답으로는 부족한 복잡한 문제를 위한 모델이라고 설명해요.
제작사 자료로 10월 15일에 확인했어요 — Gemini 3.1 Pro preview — Gemini API · Gemini 3.1 Pro — Google
- 나온 날
- 2026년 2월 19일(Google 공개).
- 한 번에 읽는 양
- 질문 · 첨부 · 앞선 대화와 답을 합쳐 약 105만 토큰 안에서 처리해요.
- 긴 입력 구간
- 입력이 약 20만 토큰을 넘으면 더 높은 단가 구간으로 셈해요(Google 공시 기준).구간 값 보기
- 회사별 대체
- 「긴 자료 읽고 정리」 · 「채점 · 수학처럼 따지기」 · 「아주 어려운 질문」에서 학교·팀이 쓸 모델을 골라 두어 앞 순서 모델을 못 부를 때 이 모델이 대신 답해요.
- 생각 깊이
- API 에서 reasoning_effort 로 생각 깊이를 정할 수 있어요 — 깊을수록 느리고 크레딧이 더 들어요.
쓰는 법
지원 엔드포인트
| 구분 | 엔드포인트 | 용도 | 문서 |
|---|---|---|---|
| 기본 | POST /v1/chat/completions | OpenAI 호환 채팅 호출 | 레퍼런스 |
| 보조 | GET /v1/models/gemini-3.1-pro-preview | 모델 규격과 키별 호출 가능 여부 조회 | 레퍼런스 |
API 로 부르기
POST /v1/chat/completionsOpenAI 호환 채팅 호출base_url: https://oneport.kr/v1OpenAI 호환 SDK base_url
curl https://oneport.kr/v1/chat/completions \
-H "Authorization: Bearer $ONEPORT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-pro-preview",
"messages": [{"role": "user", "content": "안녕하세요"}]
}'API 규격과 기능
- 최대 컨텍스트
- 1,049K 토큰
- 스트리밍
- 실시간 스트리밍(SSE) 지원
- 추론 강도 조절
- 지원 (reasoning_effort)
- 학생 키 정책
- 학생 키 기본 호출 가능 (웹 검색·페이지 읽기·원격 MCP·작업 실행 제외)