使用 Gemini API Webhooks 減少長時間執行任務的延遲與摩擦

谷歌今日宣佈為 Gemini API 引入事件驅動 Webhooks，這是一種基於推送的通知系統，旨在簡化長時間執行任務的開發流程。隨著 Gemini 向智慧體工作流和高吞吐量處理方向發展——例如深度研究、長影片生成或透過 Batch API 處理數千個提示——操作可能耗時數分鐘甚至數小時。此前，開發者必須透過持續輪詢（如重複呼叫 GET 操作）來檢查任務是否完成。現在，Gemini API 可以在任務完成時立即向伺服器推送即時的 HTTP POST 負載。

該實現嚴格遵循 Standard Webhooks 規範，確保可靠性和安全性。每個請求都使用 webhook-signature、webhook-id 和 webhook-timestamp 頭進行簽名，保證冪等性並防止重放攻擊。谷歌還保證“至少一次”交付，並在 24 小時內自動重試。

開發者可以在專案級別全域性配置 Webhooks（透過 HMAC 保護），也可以按請求動態覆蓋以路由特定任務（透過 JWKS 保護）。例如，使用 Python SDK 可以為批次任務動態配置 Webhook。該功能目前對所有 Gemini API 開發者開放，谷歌提供了詳細的文件和 Cookbook 幫助快速上手。

透過採用事件驅動架構，開發者可以構建更復雜、更高效的智慧體應用。Webhooks 減少了不必要的網路流量和延遲，讓開發者能夠專注於業務邏輯而非基礎設施輪詢。無論是處理大規模資料處理、長時間推理任務，還是即時監控，這一新功能都顯著提升了開發體驗。

谷歌表示，未來將繼續擴充套件 Webhooks 的功能，包括更多事件型別和更精細的控制選項。開發者可以立即開始使用，並在官方文件中瞭解更多資訊。