Gemini API 推推送通知替代码力空耗

用 Gemini API 处理视频生成、批量分析或者 Deep Research 这类任务时，一次操作可能花几分钟甚至几小时。此前，开发者只能靠持续轮询——每隔几秒调用一次 GET 接口，看任务是否完成。轮询既消耗时间，也浪费算力，尤其在高吞吐场景下。

Google 刚刚为 Gemini API 引入了事件驱动的 Webhooks，一种基于推送的通知系统。任务完成的那一刻，API 会向开发者的服务器发送实时 HTTP POST 负载，省掉了反复查询的步骤。这套实现严格遵循 Standard Webhooks 规范。

每个请求都带有 webhook-signature、webhook-id 和 webhook-timestamp 三个签名标头，确保消息不会被篡改，同时防止重放攻击。Google 承诺“至少一次”投递，如果失败，会在最多 24 小时内自动重试。开发者不需要额外实现安全逻辑。

配置方式也够灵活：可以在项目级别设置全局 Webhook，用 HMAC 保护；也可以在每次请求时动态覆盖，把特定作业路由到不同的地址，用 JWKS 加密。官方提供了 Python SDK 的动态配置示例。

这项功能已对所有 Gemini API 开发者开放，同时附带 Webhooks 文档和 Cookbook 帮助上手。对于普通用户来说，前端应用的等待时间会更短，因为后端不再空转着等结果。

这一改动意味着 Gemini 正从同步交互转向异步、长时间运行的工作流，主动通知是支撑该方向的基础设施。