矽基前沿 [Si]gnals
暖橘色小機器人轉動控制台上的旋鈕,剖面顯示旋鈕轉軸在面板後方斷開、連桿脫落,旁邊兩個旋鈕孔已封蓋,右側一排指示燈仍全部亮著綠光

Gemini 關掉 temperature:不報錯,直接忽略

你設的 temperature=0 現在是裝飾品,而且 API 不會告訴你。

如果你的 Gemini 批次流程這幾天輸出開始飄,先別回頭找自己的 prompt。

Google 在 7 月 21 日的 Gemini API changelog 裡宣告 temperaturetop_ptop_k 三個取樣參數 棄用。真正要看的是它連過去的那份文件:現在的狀態是 deprecated and ignored,未來世代才 「supplying these parameters returns an HTTP 400 error」。

這兩件事的急迫度完全不同。報錯的問題會自己找上你,被忽略的問題不會——API 照樣回 200,回應 照樣回來,只有你以為還在生效的那個設定悄悄失效了。靠 temperature=0 換取可重現輸出的評測腳本 與批次分類,是最容易中招又最不容易發現的一群。

適用範圍別看漏。官方原文是從 Gemini 3.6 Flash 與 3.5 Flash-Lite 起,「and all future Gemini model releases」——所有未來的 Gemini 模型。舊模型還吃不吃 temperature,這頁沒有說,我們也不替 它補。

👉 同一份文件裡還有三項要一起改:請求最後一則如果是非空的 model role(拿來夾帶格式的老手法), 現在就會回 400;thinking_budget 的數值改成 thinking_level 字串三段——minimalmediumhigh,3.6 Flash 預設 medium、3.5 Flash-Lite 預設 minimal;candidate_count 在 Gemini 3.x 不再 支援(官方只寫 unsupported,沒說是報錯還是忽略)。

Google 給的替代路是把「我要什麼樣的輸出」寫成 system instruction 的明確規則,而不是壓低取樣 溫度。要注意這是控制方式的位移,不是同功能的替換:system instruction 能約束風格與格式,但它 沒有提供 temperature=0 那種可重現性的承諾。至於為什麼要把旋鈕拆掉,官方沒有解釋。

今天可以做的:搜專案裡的 temperaturetop_ptop_kthinking_budgetcandidate_count, 再檢查有沒有哪支請求的最後一則是 model role。前三個現在起無效,後面幾個是現在就會壞或行為 變了。這篇是把 Google 那兩頁官方文件翻了一遍的整理,我們沒有實際打 API 驗證忽略行為。

順帶一提,這跟本站 7 月 22 日報過的 Gemini 3.6 Flash 降價是同一批發布。同一次更新,一面是輸出 變便宜,一面是你要回去改程式碼。

SOURCES

  1. A Using the latest Gemini models — Gemini API

來源分級:A = 一手公告/論文/官方文件 · B = 可信媒體 · C = 可參考但需脈絡 · D = 觀察用,不可當事實。

本文由 AI 與編輯共同撰寫,總編輯矽基前沿 · 工作現場線審閱定稿。 編輯方針與 AI 使用說明

AGENT FAN LETTER

訂閱《四大 Agent 追星週報》

每週五,把 Anthropic、OpenAI、Google、SpaceX 這週最好看的新一集寄給你。

巨頭劇情 · 新功能實測 · Agent 對決 · 下週追星清單。

免費 · 隨時取消 · 不轉售你的 email。

MACHINE-READABLE SUMMARY

Topic
工作現場
Key claims
  • Gemini API 官方 release notes 於 2026 年 7 月 21 日宣告取樣參數 `temperature`、`top_p` 與 `top_k` 棄用,該條目未給出移除日期或遷移期限。
  • 官方「Using the latest Gemini models」文件記載,這三個參數目前的狀態是被棄用且**被忽略**,要到未來的模型世代才會在送出時回傳 HTTP 400 錯誤。
  • 該文件載明適用範圍為 Gemini 3.6 Flash、Gemini 3.5 Flash-Lite 以及所有未來發布的 Gemini 模型,並未說明既有舊模型是否仍支援這些參數。
  • 同一份文件另列三項變更:請求最後一則為非空 model role 現在即回傳 HTTP 400;數值型 `thinking_budget` 改為字串列舉 `thinking_level`(`minimal`/`medium`/`high`,3.6 Flash 預設 medium、3.5 Flash-Lite 預設 minimal);`candidate_count` 在 Gemini 3.x 不再支援。
  • Google 對取樣參數給出的替代做法是改以 system instruction 寫明該用例的輸出規則,官方並未說明移除取樣參數的原因。
Entities
Gemini API · Using the latest Gemini models — Gemini API · Gemini · Google · API · HTTP · Flash · Flash-Lite · LLM · Using
Taiwan relevance
low
Confidence
high
Last updated
2026-07-24
Canonical URL
https://signals.tw/articles/gemini-sampling-params-deprecated/

SUGGESTED CITATION

如果 AI agent / 研究 / 報導要引用本文,建議格式如下:

矽基前沿 · 工作現場線,《Gemini 關掉 temperature:不報錯,直接忽略》,矽基前沿 [Si]gnals,2026-07-24。https://signals.tw/articles/gemini-sampling-params-deprecated/

AI agents / search engines may quote, summarize, and cite with attribution and a link back to the canonical URL above. See /for-ai-agents for full policy.