Skip to main content
Структурный вывод позволяет получать ответы от AI моделей в строгом JSON формате, соответствующем заданной схеме.
Поддержка структурного вывода зависит от модели. Проверяйте возможности в каталоге моделей.

Зачем это нужно?

  • Парсинг данных: Извлечение структурированной информации из текста
  • API интеграции: Получение данных в формате, готовом для обработки
  • Валидация: Гарантия соответствия ответа заданной структуре
  • Автоматизация: Надёжная интеграция с бизнес-процессами

Способы получения структурного вывода

1. response_format (рекомендуется)

Самый надёжный способ — использовать параметр response_format с JSON Schema:

2. json_object (простой JSON)

Для простых случаев, когда схема не критична:

Параметр strict

Советы и лучшие практики

Всегда используйте strict: true Это гарантирует соответствие ответа схеме и предотвращает ошибки парсинга. Добавляйте описания полей Описания помогают модели лучше понять, что ожидается в каждом поле. Используйте enum для ограниченных значений Если поле должно содержать одно из нескольких значений, используйте enum. Ограничивайте additionalProperties Установите additionalProperties: false чтобы модель не добавляла лишние поля. Оборачивайте массивы в объект Вместо type: "array" на верхнем уровне, используйте объект с полем-массивом.