구글 Gemini 3.5 모델이나 API를 활용해보려는 분들이라면 꼭 알고 계셔야 하는 변경 사항이 있습니다! 기존에 2.5 버전에서 생각하는 과정의 깊이를 정수형으로 지정하던 thinking_budget 파라미터 대신, 이제는 직관적인 문자열 옵션인 thinking_level을 사용해야 합니다.

만약 예전 버그 대처 방식을 그대로 써서 정수값과 문자열 값을 동시에 보내거나 기존 정수형 설정값을 유지하면 API 호출 시 바로 400 에러를 돌려받으니 주의하세요. 이번 Gemini 3.5 Flash는 기본 추론 세기가 'medium'으로 잡혀 있어서 속도와 토큰 소모 사이의 밸런스를 알아서 잘 맞춰 줍니다. 더 무겁고 복잡한 코딩이나 수학 연산 문제라면 'high'로 한 단계 올려서 쓰시면 효과적입니다 ㅎㅎ

그리고 한 가지 더 기억하셔야 할 꿀팁은 추론 설정을 활성화할 때 온도를 가급적 1.0 기본값으로 유지하셔야 한다는 점입니다. 보통 일관된 답변을 받으려고 온도를 낮추는 경우가 많은데, 추론 모델은 온도가 낮아지면 혼자 루프를 돌며 이상한 답변을 내뱉거나 성능이 급격하게 떨어질 수 있어요.

파이썬 환경에서 코드를 작성하실 때는 아래 예시처럼 새로운 추론 레벨 옵션을 정렬해서 설정해 주시면 깔끔하게 실행됩니다~

# google-genai SDK v2.0.0 이상 기준
config = types.GenerateContentConfig(
    thinking_config=types.ThinkingConfig(thinking_level="high"),
    temperature=1.0
)

구글 AI 스튜디오 화면에서도 복잡한 슬라이더 조절 대신 깔끔한 드롭다운 메뉴로 선택할 수 있으니, 개발 프로젝트나 일상 추론 업무 특성에 맞춰 알맞은 깊이로 조절해 보세요!