Первые шаги с моделями Gemini

Цели урока

• Установка и настройка Google GenAI SDK
• Текстовые и мультимодальные prompt'ы
• Настройка системных инструкций
• Управление процессом мышления, включая уровни мышления и сигнатуры мыслей
• Подсчёт token'ов

О чём урок

Google Gen AI SDK предоставляет унифицированный интерфейс для Gemini моделей как через Gemini Developer API, так и через Gemini API на Vertex AI. За некоторыми исключениями, код, работающий на одной платформе, будет работать и на другой. Этот notebook использует Developer API. В этом notebook вы узнаете: Настройка параметров модели Генерация изображений Фильтры безопасности Начало многоэтапного чата и сохранение/возобновление бесед Генерация потока контента и отправка асинхронных запросов Управление генерируемым output'ом (режим JSON) Использование вызова функций файлов (текста, изображений, PDF, аудио, видео) Управление разрешением медиа Обоснование с помощью Google Поиска, Google Карт, YouTube или URL Использование выполнения кода Кэширование контекста Генерация embedding'ов Миграция с Gemini 2.5 Более подробная информация об SDK представлена в документации. Примечание: Этот notebook использует Interactions API, новейший способ взаимодействия с Gemini моделями. Interactions API предоставляет встроенное управление состоянием беседы, что упрощает многоэтапные беседы — достаточно передать previous_interaction_id вместо того чтобы управлять историей чата самостоятельно. Ищете версию с generateContent? Ознакомьтесь с notebook'ом «Начало работы с Generate Content». Модели, ориентированные на определённые функции, имеют свои собственные руководства: Генерация подкастов и речи с использованием Gemini TTS , Живое взаимодействие с Gemini Live , Генерация изображений с использованием Imagen , Генерация видео с использованием Veo , Генерация музыки с использованием Lyria RealTime . Установите SDK из PyPI. Рекомендуется всегда использовать последнюю версию. Чтобы запустить следующую cell, ваш API key должен быть сохранён в Colab Secret под именем GEMINI_API_KEY. Если у вас ещё нет API key или вы не знаете, как создать Colab Secret, см. Authentication для пошагового руководства. С новым SDK вам теперь нужно только инициализировать клиент с вашим API key (или OAuth, если вы используете Vertex AI). Модель теперь устанавливается при каждом вызове. Выберите модель, которую вы хотите использовать в этом руководстве. Вы можете выбрать одну из списка или ввести имя модели вручную.

План урока

1. Настройка
2. Установка SDK
3. Настройте ваш API key
4. Инициализация SDK клиента
5. Выберите модель
6. Отправка текстовых prompt'ов
7. Добавление системных инструкций
8. Подсчёт token'ов