О чём урок
Gemini API можно использовать для генерации вывода JSON, если вы зададите схему, которую хотите использовать.
Доступны два метода. Вы можете либо задать желаемый вывод в запросе, либо предоставить схему модели отдельно.
Примечание: В этом блокноте используется Interactions API — новейший способ взаимодействия с моделями Gemini. Ищете версию generateContent? Проверьте архивную ветку.
Чтобы запустить следующую ячейку, ваш ключ API должен быть сохранен в Colab Secret с именем GEMINI_API_KEY. Если у вас еще нет ключа API или вы не знаете, как создать Colab Secret, см. Аутентификация для пошагового руководства.
Для этого первого примера просто опишите желаемую схему в самом запросе и попросите модель вернуть JSON, используя response_format.
Параметр response_format со значением {"type": "text", "mime_type": "application/json"} указывает модели выводить только валидный JSON — без него модель может обернуть JSON в блоки кода markdown или добавить пояснительный текст вокруг него.
Разбор строки в JSON:
Ответ от interactions.create предоставляет удобные свойства. Для текстовых ответов доступ к выводу осуществляется напрямую через interaction.output_text.
Для удобства чтения сериализуйте и распечатайте его:
Другой вариант — передать схему напрямую через параметр response_format. Вывод модели будет точно соответствовать этой схеме.
Вы можете определить свою схему как класс Python, используя Pydantic (или typing_extensions.TypedDict), и использовать .model_json_schema() для автоматической генерации JSON Schema. Это гораздо чище, чем писать сырую JSON Schema вручную:
Используйте .model_json_schema() для автоматической генерации JSON Schema из вашей модели Pydantic. Это рекомендуемый подход — он позволяет избежать написания длинных словарей JSON Schema вручную:
Вы также можете проверить ответ непосредственно в вашей модели Pydantic, используя model_validate_json() для обеспечения безопасности типов:
Совет: Подход Pydantic с model_json_schema() является рекомендуемым методом — он поддерживает синхронизацию вашей схемы с вашим кодом, обеспечивает встроенную проверку и позволяет избежать ошибок при ручном создании JSON Schema.
Подробности см. в документации по структурированному выводу, включая…
План урока
- Установка зависимостей
- Настройка ключа API
- Установка ограниченного вывода в запросе
- Прямая передача схемы модели
- Следующие шаги
- Полезные ссылки на API
- Связанные примеры
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.