Gemini 3.1 Pro Preview vs Customtools: 어떤 버전을 사용해야 할까요?

Gemini 3.1 Pro의 두 이름은 모두 Google의 공식 모델 ID입니다. gemini-3.1-pro-preview는 일반 모델입니다. gemini-3.1-pro-preview-customtools는 에이전트가 bash에도 접근할 수 있을 때 맞춤 도구를 더 잘 활용하도록 설계된 변형입니다. 접미사가 “더 많은 사고”를 뜻하지는 않으며, 일반 모델도 이미 함수 호출을 지원합니다.^[1]

일반적인 코딩, 문서 분석, 멀티모달 질문에는 일반 Preview가 합리적인 출발점입니다. 에이전트가 의도한 맞춤 함수 대신 셸 명령을 반복해서 선택한다면 Customtools와 비교해 보세요. 이 권고는 문서에 명시된 차이에 근거하며, 이 글은 새 A/B 벤치마크를 보고하지 않습니다.

두 가지 Gemini 3.1 Pro 모델 ID

설정에 전체 식별자를 복사하세요. 두 ID 모두 preview를 포함합니다. Customtools는 해당 릴리스 계열 안에서 선택하는 별도 버전입니다.

Google은 모델 페이지에 두 이름을 함께 안내합니다. 또한 해당 도구 워크플로의 이점을 얻지 못하는 질문에서는 Customtools 버전의 품질에 변동이 있을 수 있다고 경고합니다. 따라서 접미사가 다르다는 것은 특정 동작을 평가할 이유이지 전반적인 업그레이드의 증거는 아닙니다.^[1]

공통 모델 사양에는 입력 한도 1,048,576 토큰, 출력 한도 65,536 토큰, 멀티모달 입력, 텍스트 출력이 명시되어 있습니다. 이러한 주요 한도만으로 특정 대화에서 에이전트가 어떤 도구를 선택할지는 알 수 없습니다. 결과를 비교할 때 모델 식별자, 도구 정의, 작업 결과를 구분하세요.

Customtools에서 달라지는 점

Google은 bash도 사용할 수 있을 때 view_file, search_code 같은 맞춤 함수를 우선한다고 설명합니다. 애플리케이션에 출력과 권한을 예측할 수 있는 범위가 좁은 도구가 이미 정의되어 있다면 이 차이가 중요합니다.^[1]

파일 하나를 읽는 함수, 저장소 심벌을 검색하는 함수, 범용 셸 도구라는 세 가지 선택지를 가진 가상의 코딩 어시스턴트를 생각해 보세요. 작업은 함수 정의를 찾는 것입니다. 저장소 검색 함수와 셸 명령 모두 도움이 될 수 있습니다. 유용한 질문은 모델이 애플리케이션에서 의도한 워크플로에 가장 적합한 도구를 선택하는가입니다.

이는 설명을 위한 상황이며 어느 모델에서 수집한 응답도 아닙니다. Customtools는 특정 호출을 보장하지 않고, 함수 선언을 불필요하게 만들거나 애플리케이션의 권한 확인을 대신하지도 않습니다. 호출을 실행할지, 어떤 결과를 반환할지는 여전히 애플리케이션이 결정합니다.

이 구분은 도구 선택 문제를 관찰한 뒤에 가장 중요해집니다. 일반 모델이 이미 의도한 함수를 선택하고 작업을 완료한다면, 측정할 개선점을 먼저 파악하지 않은 채 변형을 바꾸는 것은 변수를 하나 더하는 일입니다.

Customtools는 사고 수준이 아닙니다

Gemini 3.1 Pro에는 low, medium, high라는 별도의 사고 수준이 있습니다. 네이티브 generateContent의 기본값은 high이며 이 모델은 minimal을 지원하지 않습니다. 이는 생성 설정이지 다른 모델 ID가 아닙니다.^[2]

low에서 high로 바꾸면 작업에 쓰이는 추론 예산이 달라질 수 있습니다. 모델 ID를 Customtools로 바꾸는 것은 도구 선택 동작을 겨냥합니다. 둘을 동시에 바꾸면 답변이 달라져도 어느 변경이 영향을 미쳤는지 알 수 없습니다.

유용한 비교를 위해 프롬프트, 도구 선언, 대화 기록, 사고 수준, 출력 한도를 동일하게 유지하세요. Google은 Gemini 3에서 temperature를 1.0으로 유지하는 것도 권장합니다. 요청한 작업을 완료했는지, 어떤 도구를 호출했는지, 인수가 유효했는지, 응답에 보고된 사용량이 얼마인지 비교하세요. 이는 평가 제안이며 어느 변형의 측정된 장점을 뜻하지 않습니다.

일반 Preview에서도 함수를 사용할 수 있습니다

공식 일반 모델 사양에는 함수 호출 지원이 명시되어 있습니다. 함수를 선언하고, 함수 호출을 받고, 애플리케이션에서 실행한 뒤 결과를 돌려주는 데 Customtools 접미사는 필요하지 않습니다.^[1]

함수 인터페이스에 네이티브 tools[].functionDeclarations를 사용하세요. 대화를 계속할 때 반환된 콘텐츠 파트와 사고 서명을 보존합니다. 누락된 서명, 잘못된 인수 스키마, 잘못 조립한 도구 응답으로 인한 실패는 프로토콜 문제입니다. 모델 이름을 바꿨다는 사실만으로 해결되었다고 볼 수는 없습니다.

Gemini 3.1 Pro API 참조 문서는 네이티브 필드와 제약을 나열합니다. 전체 도구 모음을 추가하기 전에 작은 함수와 확인 가능한 결과부터 시작하세요.

실제 워크플로에 맞게 선택하기

주요 작업이 텍스트 생성, 코드 설명, 문서 추출 또는 멀티모달 분석이라면 먼저 일반 Preview를 선택하세요. 도구를 사용하는 애플리케이션의 출발점으로도 유효합니다. 평가 전에 성공적인 결과의 기준을 정합니다.

애플리케이션이 bash와 맞춤 도구를 함께 사용하고 재현할 구체적인 선택 문제가 있다면 Customtools를 비교하세요. 범위가 좁은 함수가 적절한 사례, 실제로 셸이 필요한 사례, 도구를 호출하지 않아야 하는 사례로 짧은 대표 사례 집합을 유지합니다. 선택한 동작과 최종 결과를 모두 검토하세요.

선호하는 도구를 호출하는 빈도만으로 변형을 판단하지 마세요. 불필요한 함수 호출은 여전히 불필요합니다. 유용한 모델은 적절한 동작을 선택하고, 유효한 인수를 제공하며, 결과를 해석하고 원래 요청에 답해야 합니다.

Google 요금 페이지는 두 ID를 같은 모델 요금표에 묶습니다. 그렇다고 사고, 처리 등급 선택, 토큰 사용량을 동일하게 취급할 수 있는 것은 아닙니다. 요청을 비교할 때 적용되는 현재 요율과 실제 사용량을 확인하세요.^[3]

SeedRouter는 어떤 버전을 연결하나요?

Gemini 3.1 Pro 페이지는 **gemini-3.1-pro-preview**를 사용합니다. 이 연동에는 Customtools 변형이 연결되어 있지 않습니다. 페이지는 일반 모델의 Playground와 실시간 그룹별 요금을 제공하며, API 참조 문서는 현재 검증 한계를 기록합니다.

애플리케이션에서 정확한 일반 모델 ID를 사용하세요. 조건을 통제한 평가를 위해 처리 설정을 명시하고, 구성을 프로덕션에 적합하다고 판단하기 전에 자신의 작업에서 결과를 확인합니다.

자주 묻는 질문

Gemini 3.1 Pro의 두 모델 이름은 모두 공식인가요?

네. Google은 같은 모델 페이지에 gemini-3.1-pro-preview와 gemini-3.1-pro-preview-customtools를 모두 명시합니다. 후자는 비공식 표기가 아니라 특화된 변형입니다.

Customtools가 일반 함수 호출을 대체하나요?

아니요. 일반 Preview에서도 함수 호출을 사용할 수 있습니다. Customtools는 맞춤 도구와 bash가 섞인 워크플로에서 모델의 선호 경향을 바꿉니다. 함수 선언과 실행은 여전히 애플리케이션이 담당합니다.

코딩에는 Customtools가 항상 더 나은가요?

Google은 그렇게 일괄적으로 주장하지 않습니다. 문서에 명시된 차이는 도구 선택에 관한 것이며, 모델 페이지는 의도한 워크플로 밖에서 품질 변동이 있을 수 있다고 경고합니다. 코딩 애플리케이션에 실제로 필요한 동작을 비교하세요.

출처

2026년 10월 17일에 확인했습니다. 위 비교는 문서에 근거하며 새로 실행한 품질 벤치마크가 아닙니다.

1. Google: Gemini 3.1 Pro 모델 사양 — 공식 ID, 입출력 한도, 함수 호출과 Customtools의 차이.
2. Google: 네이티브 Gemini 3 개발자 가이드 — 사고 수준, 네이티브 요청 설정과 temperature 지침.
3. Google: Gemini API 요금 — 두 모델 ID가 공유하는 공식 요금표.