О чём урок
Этот блокнот содержит быстрые примеры кода, демонстрирующие, как использовать Gemini API с видеофайлом с помощью curl. В этом случае вы будете использовать короткий клип из Big Buck Bunny.
Вы можете запустить это в Google Colab или скопировать/вставить команды curl в свой терминал.
Для запуска этого блокнота ваш ключ API должен быть сохранен в Colab Secret с именем GEMINI_API_KEY. Если вы работаете в другой среде, вы можете сохранить свой ключ в переменной среды. Подробнее см. в разделе Аутентификация.
Важно: File API использует ключи API для аутентификации и доступа. Загруженные файлы связаны с облачным проектом ключа API. В отличие от других Gemini API, использующих ключи API, ваш ключ API также предоставляет доступ к данным, которые вы загрузили в File API, поэтому будьте особенно осторожны при обеспечении безопасности вашего ключа API. Рекомендации по обеспечению безопасности ключей API см. в центре поддержки консоли API.
Установите jq для обработки ответов JSON API.
Gemini API принимает форматы видеофайлов через File API. File API принимает файлы размером до 2 ГБ и может хранить до 20 ГБ файлов на проект. Файлы хранятся в течение 2 дней и не могут быть загружены из API. Для этого примера вы будете использовать короткометражный фильм "Big Buck Bunny".
"Big Buck Bunny" является (C) Copyright 2008, Blender Foundation / www.bigbuckbunny.org и лицензирован по лицензии Creative Commons Attribution 3.0.
Примечание: В Colab вы также можете загружать свои собственные файлы для использования.
Теперь, когда видеофайл доступен локально, сгенерируйте некоторые метаданные, которые вы будете использовать на последующих шагах.
Загрузка медиафайлов в File API является возобновляемой, поэтому первым шагом является определение задачи загрузки. Этот первоначальный запрос дает вам ссылку, которую вы можете использовать для последующих операций загрузки, и позволяет вам запрашивать статус загрузки перед отправкой данных, в случае проблем с сетью во время передачи данных.
API возвращает URL-адрес загрузки в заголовке x-goog-upload-url…
План урока
- Настройка среды
- Обзор аутентификации
- Использование видеофайла с Gemini API
- Начать задачу загрузки
- Загрузить видеоданные
- Получить информацию о файле
- Дождаться обработки
- Подсказка с видео
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.