電子報：Google Production: Event-driven webhooks are now available in Gemini API

Email not displaying correctly? View it online

Event-driven webhooks are are now in Gemini API

Hi 勇汀,

Tired of polling for job status? Gemini API now supports webhooks to provide real-time HTTP POST notifications that hit your server the moment a batch job completes, a video finishes generating, or an agent workflow needs attention.

Why webhooks

Real-time alerts: Get notified the moment your massive batch or long video generation task is done.
Secure & reliable: Built on the Standard Webhooks specification, featuring signed requests and guaranteed "at-least-once" delivery with backoff.
Flexible setup: Supports both static (project-level) and dynamic (per-request) webhook registration.

Get started in minutes

All you need is an HTTPS endpoint that can receive POST requests and your Gemini API key. Here's a quick example of how you can dynamically configure a webhook for a Gemini batch job using the Python SDK:

from google import genai
from google.genai import types


                       client = genai.Client()
 
webhook_config = types.WebhookConfig(
    uri="https://your-server.com/webhooks/gemini",
    subscribed_events=["video.generated"]
)


                       operation = client.models.generate_videos(
    model="veo-3.1-generate-preview",
    prompt="A stunning drone view of the Grand Canyon.",
    config={"webhook_config": webhook_config}
)

print(f"Video generation job {operation.name} started! You'll be notified at your webhook URI.")