온도와 파라미터가 뭘 바꾸나

내용

📌 무엇을 조절하는 값인가

temperature — 답이 얼마나 갈리는가
  낮게(0에 가깝게) → 매번 비슷한 답
  높게              → 매번 다른 답
  ⚠️ Gemini 3 부터는 건드리지 마세요 (아래 참고)

topK / topP — 다음 단어 후보를 얼마나 넓게 볼 것인가
  좁히면 안전하고 밋밋하게, 넓히면 다양하고 튀게

max_tokens — 답의 최대 길이
  짧게 잡으면 문장 중간에 잘립니다. 넉넉히 잡되 프롬프트로 길이를 지시하세요

stop_sequences — 이 문자열이 나오면 멈춤
  형식이 정해진 출력에서 뒤에 덧붙는 말을 막을 때

[ 실무 요령 ]
• 같은 질문에 매번 다른 답이 나와 곤란하다 → temperature 를 낮추세요
• 계속 비슷한 말만 반복한다 → temperature 를 올리세요
• 답이 자꾸 잘린다 → max_tokens 부터 확인하세요

⚠️ 앱(gemini.google.com)에서는 이 값들이 안 보입니다.
   AI Studio 나 API 를 쓸 때 나타납니다.

⚠️ 파라미터로 고칠 수 있는 문제와 프롬프트로 고칠 문제는 다릅니다.
   내용이 틀리는 건 온도를 낮춰도 안 고쳐집니다. 그건 프롬프트나 자료 문제입니다.

궁금한 점: {{INPUT}}

⚠️ 추론 모델에서는 온도를 못 씁니다
생각을 많이 하는 모델에서는 temperature·top_p 가 무시되는 게 아니라
요청 자체가 거부되기도 합니다. (OpenAI 아스트라가 그렇습니다)

일반 모델에서 쓰던 설정을 그대로 옮기면 여기서 막힙니다.
추론 모델에서는 온도 대신 사고량(effort · thinking_level)으로 조절하세요.

⚠️ Gemini 3 부터는 온도를 설정하지 마세요 (2026-09 확인)
"사실 정리에는 온도를 낮춰라" 는 Gemini 2.5 까지의 이야기입니다.
구글은 Gemini 3 부터 temperature 를 아예 지정하지 말고 기본값 1.0 을 쓰라고 권합니다.
낮게 두면 같은 말을 반복하는 루프에 빠지거나 복잡한 작업에서 성능이 떨어집니다.

예전 코드에 temperature 를 0 이나 0.1 로 박아뒀다면 그 줄을 지우세요.
조절은 thinking_level 로 하세요.

💡 「Gemini 3에는 온도를 건드리지 마세요」 항목을 함께 보세요.