О чём урок
Предварительная версия: Поддержка Webhooks в Gemini API в настоящее время находится на стадии предварительного просмотра.
Webhooks позволяют Gemini API отправлять уведомления в реальном времени на ваш сервер, когда завершаются асинхронные или длительные операции (LROs). Это устраняет необходимость постоянного опроса API для получения обновлений статуса, уменьшая задержку и накладные расходы.
Webhooks доступны для таких операций, как задания Batch, Interactions и генерация видео.
Вместо многократного опроса GET /operations для проверки завершения задания вы можете настроить Webhooks Gemini API для отправки HTTP POST запроса на ваш URL-адрес прослушивателя немедленно после срабатывания события.
Gemini API поддерживает два способа настройки webhooks:
- Static webhooks: Эндпоинты уровня проекта. Подходят для глобальных интеграций (например, уведомления Slack, синхронизация базы данных и т. д.).
- Dynamic webhooks: Переопределения на уровне запроса, передающие webhook URL в конфигурационной полезной нагрузке вызова конкретного задания. Идеально подходят для маршрутизации конкретных заданий на выделенные эндпоинты.
Установите SDK из PyPI.
Чтобы запустить следующий cell, ваш API key должен быть сохранен в Colab Secret с именем GEMINI_API_KEY. Если у вас еще нет API key или вы не знаете, как создать Colab Secret, см. Authentication для пошагового руководства.
Инициализируйте клиент с вашим API key:
В этом примере используется функция Google Cloud Run, которая позволяет легко развернуть бессерверную функцию, которую вы можете использовать в качестве нашего эндпоинта webhook.
- Перейдите по ссылке https://console.cloud.google.com/run/
- Нажмите NodeJS под "Write a function"
- Введите имя, например "gemini-webhook-receiver", и выберите "Allow public access" в разделе Authentication
- Нажмите "Deploy". Если вы развертываете функцию Cloud Run впервые, вам может потребоваться включить API, такие как Cloud Build, по запросу.
(Их UI управления по адресу https://console.cloud.google.com/run/ имеет страницу просмотра логов, вы можете видеть запросы там)
- Реализация верификации подписи webhook: На вкладке Source обновите зависимости package.json следующим образом:
Обновите точку входа функции на geminiWebhook
и замените код в…
План урока
- Как это работает
- Установка SDK
- Настройка вашего API key
- Инициализация клиента SDK
- Шаг 1: Создание эндпоинта webhook
- Шаг 2: Создание webhook и добавление секрета в функцию Cloud Run
- Список
- Получить/Проверить/Удалить/Обновить
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.