Урок из полного доступа, первые уроки курса бесплатно Официальный курс Gemini API Cookbook на русском
Урок 39 · Текст · ~5 мин

Ответы в формате JSON

Урок 39 из 71 курса «Gemini API: быстрый старт»: официальный курс Gemini API Cookbook (Гугл Джемини) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

О чём урок

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.

Подробности см. в документации по структурированному выводу, включая…

План урока

  1. Установка зависимостей
  2. Настройка ключа API
  3. Установка ограниченного вывода в запросе
  4. Прямая передача схемы модели
  5. Следующие шаги
  6. Полезные ссылки на API
  7. Связанные примеры

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Откройте полный доступ

Вы прошли бесплатные уроки. Выберите тариф, чтобы продолжить обучение.

Курсы Google Gemini 1 490 ₽ Разовый платёж, навсегда
  • Все курсы от Google Gemini (2 шт.)
  • Именной сертификат по каждому пройденному курсу
Оплатить
Полный доступ 4 900 ₽ Разовый платёж, навсегда
  • Все 77 курсов от 11 AI-провайдеров
  • Библиотека промптов и новые курсы
Оплатить

Безопасная оплата через Robokassa: СБП, карты, электронные кошельки. Доступ откроется в этом браузере и придёт письмом. Уже оплатили? Восстановить доступ

Урок входит в темы

Полезные гиды