Gemini API 推出 Webhooks：Google 解决长期任务轮询痛点、Batch／Veo 可即时推送

Google 5 月 4 日於 Gemini API 上線 Webhooks 功能、解決长任務（long-running jobs）开发者痛点。Google 官方部落格说明、Webhooks 是事件驅动的推送通知机制、开发者不必再用輪詢（polling）方式持续向 Gemini API 詢问任務狀態—API 完成后会主动把結果推送到开发者指定的 endpoint。Google AI 开发者关係主管 Logan Kilpatrick（@OfficialLoganK）在 X 上稱这是「对长任務 DevX 的重要一步」。

解決什麼问題：batch、影片生成、长 reasoning 的輪詢成本

过去 Gemini API 开发者面对 batch（批次處理）、影片生成（Veo 2）、长 reasoning 任務时、必須每隔幾秒呼叫一次 status endpoint 確认任務进度。这種模式在资源消耗、API quota、延遲三个層面都不理想：

资源浪费—大量无意義的 status check 呼叫、占用 API quota

延遲不可控—polling 间隔太短燒 quota、太长則得知結果延后

程式碼複雜—需要在客戶端寫狀態机管理多个並行任務的輪詢

Webhooks 把这个模式翻转：开发者註冊一个 callback URL、Gemini API 完成任務时主动 POST 結果到該 URL、客戶端只需處理推送即可。

适用情境：Batch API、Veo 2 影片、长 context 推理

本次推出的 Webhooks 主要适用三類非同步任務：

Batch API—Gemini 的批次處理 endpoint、用於大量文字、嵌入向量、分類任務、官方提供 50% 的折扣价、目標 24 小时回应、实际多在數小时內完成

影片生成（Veo 2）—單支影片生成需要分鐘級时间、过去开发者要不停輪詢

长 context 推理—1M token 以上的长文件分析、Gemini 內部處理可能需數十秒至數分鐘

对开发者实作而言、註冊 webhook 后、客戶端可以「丟出任務、忘記它」、結果完成时自然由 Gemini 主动通知。这个模式特別适合无伺服器（serverless）架構、后端只在事件到达时被喚醒、不必維持輪詢进程。

对 OpenAI、Anthropic 的对位：誰先做、誰后做

长任務 webhook 在三大 AI 平台的进度：

Google Gemini：5 月 4 日推出 Webhooks（本案）、batch、影片、长 reasoning 全部覆蓋

OpenAI：Codex、Sora 2 等长任務目前主要靠 SSE（Server-Sent Events）串流、批次任務有獨立 endpoint 但无原生 webhook

Anthropic：Claude API 暫无原生 webhook、Claude Code 內部用 polling 机制處理长任務

Google 在 DevX（developer experience）这條軸線上、过去 12 个月明顯加大投资—从 Gemini 2.5 Pro 的 1M context、AI Studio 的視覺化开发、Cloud Next 2026 推出的 Agent Designer、Memory Bank、到本次的 Webhooks—相对於 OpenAI 对「直接消费端产品」（ChatGPT、Operator）的優先序、Google 走的是「企业／开发者基建」路線。Webhooks 是这條路線的具體一塊。

后续觀察：webhook 安全机制、适用模型範圍

下一階段的觀察重点：

Webhook 安全机制—Gemini 是否提供 HMAC 簽章验证、避免 callback URL 被偽造请求轟炸

适用模型擴展—目前涵蓋 batch、Veo 2、长 reasoning、未来 Imagen 影像生成、Speech-to-Speech、Gemini Live 是否一併支援

OpenAI、Anthropic 的回应—当 Google 把 DevX 拉到这个水平、競爭对手是否跟进

对台灣开发者实務而言、若你正在用 Gemini API 做 batch 任務（例如批次處理客戶资料分類、文件摘要）、Webhooks 是值得立即整合的功能、可大幅降低 API quota 消耗与系统複雜度。

这篇文章 Gemini API 推 Webhooks：Google 解決长任務輪詢痛点、Batch／Veo 可即时推送 最早出现於 链新聞 ABMedia。