Webhooks в Gemini API сокращают задержки длительных задач
Google добавил поддержку вебхуков в Gemini API, позволяя получать уведомления о завершении длительных запросов вместо постоянного опроса, что снижает нагрузку и ускоряет обработку.
Google AI объявил о новой возможности в Gemini API – поддержке event‑driven вебхуков для длительных задач. Раньше разработчикам приходилось регулярно опрашивать статус‑эндпоинт, ожидая завершения тяжёлых операций, таких как пакетные эмбеддинги, генерация мультимодального контента или сложные аналитические запросы. Теперь можно указать URL‑адрес webhook‑получателя, и сервис автоматически отправит POST‑запрос с подписью JWT, когда задача перейдёт в состояние completed или failed.
Для настройки требуется:
- Зарегистрировать безопасный HTTPS‑эндпоинт, поддерживающий проверку подписи.
- Указать его в параметре
webhook_urlпри создании задания через методjobs.create. - При необходимости задать
webhook_secretдля дополнительной аутентификации.
Google обещает, что вебхуки работают с минимальной задержкой (меньше 500 мс после изменения статуса) и поддерживают до 100 сообщений в секунду, что покрывает большинство производственных сценариев. Документация также описывает retry‑политику и ограничения на размер полезной нагрузки.
Плюсы новой функции очевидны: снижается количество запросов к API, экономятся вычислительные ресурсы и уменьшаются расходы на сетевой трафик. Кроме того, разработчики могут построить полностью асинхронные конвейеры обработки данных, реагируя на событие завершения без задержек, характерных для polling‑моделей.
Подробнее о реализации и примерах кода можно узнать в официальном блоге Google AI и в разделе «Webhooks» документации Gemini API.
Для разработчиков это шанс избавиться от постоянного polling‑цикла и сократить расходы на запросы. Асинхронные пайплайны станут проще и быстрее, особенно в проектах с большими объёмами данных. Однако необходимо обеспечить надёжную защиту webhook‑эндпоинта: проверка подписи и ограничение доступа – обязательные меры. Внедрение вебхуков открывает путь к более реактивным и масштабируемым AI‑сервисам.
