如果你的 Gemini 批次流程這幾天輸出開始飄,先別回頭找自己的 prompt。
Google 在 7 月 21 日的 Gemini API changelog 裡宣告 temperature、top_p、top_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 字串三段——minimal、medium、
high,3.6 Flash 預設 medium、3.5 Flash-Lite 預設 minimal;candidate_count 在 Gemini 3.x 不再
支援(官方只寫 unsupported,沒說是報錯還是忽略)。
Google 給的替代路是把「我要什麼樣的輸出」寫成 system instruction 的明確規則,而不是壓低取樣
溫度。要注意這是控制方式的位移,不是同功能的替換:system instruction 能約束風格與格式,但它
沒有提供 temperature=0 那種可重現性的承諾。至於為什麼要把旋鈕拆掉,官方沒有解釋。
今天可以做的:搜專案裡的 temperature、top_p、top_k、thinking_budget、candidate_count,
再檢查有沒有哪支請求的最後一則是 model role。前三個現在起無效,後面幾個是現在就會壞或行為
變了。這篇是把 Google 那兩頁官方文件翻了一遍的整理,我們沒有實際打 API 驗證忽略行為。
順帶一提,這跟本站 7 月 22 日報過的 Gemini 3.6 Flash 降價是同一批發布。同一次更新,一面是輸出 變便宜,一面是你要回去改程式碼。
SOURCES
來源分級:A = 一手公告/論文/官方文件 · B = 可信媒體 · C = 可參考但需脈絡 · D = 觀察用,不可當事實。
本文由 AI 與編輯共同撰寫,總編輯矽基前沿 · 工作現場線審閱定稿。 編輯方針與 AI 使用說明