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

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

Парсинг данных

Извлечение структурированной информации из текста

API интеграции

Получение данных в формате, готовом для обработки

Валидация

Гарантия соответствия ответа заданной структуре

Автоматизация

Надёжная интеграция с бизнес-процессами

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

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

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

const openai = new OpenAI({
  baseURL: 'https://polza.ai/api/v1',
  apiKey: '<POLZA_AI_API_KEY>'
});

const completion = await openai.chat.completions.create({
  model: 'openai/gpt-4o',
  messages: [
    {
      role: 'user',
      content: 'Извлеки информацию о товаре: iPhone 15 Pro, 256GB, цена 89990 рублей, в наличии'
    }
  ],
  response_format: {
    type: 'json_schema',
    json_schema: {
      name: 'product',
      strict: true,
      schema: {
        type: 'object',
        properties: {
          name: { type: 'string', description: 'Название товара' },
          storage: { type: 'string', description: 'Объём памяти' },
          price: { type: 'number', description: 'Цена в рублях' },
          in_stock: { type: 'boolean', description: 'Наличие на складе' }
        },
        required: ['name', 'storage', 'price', 'in_stock'],
        additionalProperties: false
      }
    }
  }
});

const product = JSON.parse(completion.choices[0].message.content);
console.log(product);
// { name: "iPhone 15 Pro", storage: "256GB", price: 89990, in_stock: true }

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

Для простых случаев, когда схема не критична: 
const completion = await openai.chat.completions.create({
  model: 'openai/gpt-4o',
  messages: [
    {
      role: 'system',
      content: 'Всегда отвечай в формате JSON с полями: name, price, currency'
    },
    { role: 'user', content: 'Цена на MacBook Air?' }
  ],
  response_format: { type: 'json_object' }
});

​
Примеры схем

​
Извлечение контактов

{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "email": { "type": "string", "format": "email" },
    "phone": { "type": "string" },
    "company": { "type": "string" }
  },
  "required": ["name"]
}

​
Анализ отзыва

{
  "type": "object",
  "properties": {
    "sentiment": {
      "type": "string",
      "enum": ["positive", "negative", "neutral"]
    },
    "score": { "type": "number", "minimum": 1, "maximum": 5 },
    "topics": {
      "type": "array",
      "items": { "type": "string" }
    },
    "summary": { "type": "string" }
  },
  "required": ["sentiment", "score", "summary"]
}

​
Список задач

{
  "type": "object",
  "properties": {
    "tasks": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": { "type": "string" },
          "priority": { "type": "string", "enum": ["low", "medium", "high"] },
          "due_date": { "type": "string", "format": "date" }
        },
        "required": ["title", "priority"]
      }
    }
  },
  "required": ["tasks"]
}

​
Параметр strict

ЗначениеОписание
trueОтвет точно соответствует схеме. Рекомендуется.
falseМодель может отклоняться от схемы. Не рекомендуется.
При strict: true модель гарантированно вернёт JSON, соответствующий схеме, или ошибку.

​
Обработка массивов

Для извлечения списка объектов: 
const completion = await openai.chat.completions.create({
  model: 'openai/gpt-4o',
  messages: [
    {
      role: 'user',
      content: 'Извлеки все упомянутые компании: Apple выпустила iPhone, Google показала Pixel, Microsoft представила Surface'
    }
  ],
  response_format: {
    type: 'json_schema',
    json_schema: {
      name: 'companies',
      strict: true,
      schema: {
        type: 'object',
        properties: {
          items: {
            type: 'array',
            items: {
              type: 'object',
              properties: {
                company: { type: 'string' },
                product: { type: 'string' }
              },
              required: ['company', 'product'],
              additionalProperties: false
            }
          }
        },
        required: ['items'],
        additionalProperties: false
      }
    }
  }
});

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

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

​
Следующие шаги

Tool Calling

Вызов функций для получения данных

Плагины

Расширение возможностей моделей