Видео в промпте через REST

О чём урок

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

План урока

1. Настройка окружения
2. Обзор Authentication
3. Использование видеофайла с Gemini API
4. Начало задачи загрузки
5. Загрузка видеоданных
6. Получение информации о файле
7. Ожидание обработки
8. Prompting с видео