Плагины

Плагины расширяют возможности любой модели, добавляя функции поиска в интернете, обработки PDF и автоматического исправления JSON. Плагины подключаются через параметр plugins в запросе.

Доступные плагины

Плагин	ID	Описание
Поиск в интернете	`web`	Дополнение ответов актуальными данными из интернета
Парсинг файлов	`file-parser`	Извлечение текста из PDF документов
Исправление ответов	`response-healing`	Автоматическое исправление невалидного JSON в ответах

Подключение плагинов

Добавьте массив plugins в запрос к /v1/chat/completions:

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: 'Какие последние новости в сфере AI?' }
  ],
  // @ts-ignore — plugins не входит в типы OpenAI SDK
  plugins: [
    { id: 'web' }
  ]
});

from openai import OpenAI

client = OpenAI(
    base_url="https://polza.ai/api/v1",
    api_key="<POLZA_AI_API_KEY>"
)

completion = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[
        {"role": "user", "content": "Какие последние новости в сфере AI?"}
    ],
    extra_body={
        "plugins": [
            {"id": "web"}
        ]
    }
)

curl -X POST "https://polza.ai/api/v1/chat/completions" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [
      {"role": "user", "content": "Какие последние новости в сфере AI?"}
    ],
    "plugins": [
      {"id": "web"}
    ]
  }'

Несколько плагинов

Можно подключить несколько плагинов одновременно:

{
  "model": "openai/gpt-4o",
  "messages": [...],
  "plugins": [
    { "id": "web", "max_results": 3 },
    { "id": "response-healing" }
  ],
  "response_format": {
    "type": "json_schema",
    "json_schema": { ... }
  }
}

Отключение плагина

Чтобы отключить плагин для конкретного запроса, передайте enabled: false:

{
  "plugins": [
    { "id": "web", "enabled": false }
  ]
}

Поиск в интернете (web)

Плагин web дополняет ответ модели актуальными результатами поиска в интернете. Работает с любой моделью — от GPT-5 до Claude и Gemini. Подробное руководство по веб-поиску, включая параметры, формат ответа, совместимость моделей и Responses API — на странице Поиск в интернете.

Парсинг файлов (file-parser)

Плагин file-parser извлекает текст из PDF документов для обработки моделью.

Параметры

Параметр	Тип	Описание
`enabled`	boolean	Включить/выключить плагин
`pdf.engine`	string	Движок обработки PDF

Движки обработки PDF

Значение	Описание
`pdf-text`	Извлечение текста из PDF
`mistral-ocr`	OCR через Mistral (для сканов и изображений)
`native`	Встроенная обработка провайдера

Пример

{
  "model": "openai/gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "Проанализируй этот документ" },
        {
          "type": "file",
          "file": {
            "filename": "report.pdf",
            "file_data": "data:application/pdf;base64,..."
          }
        }
      ]
    }
  ],
  "plugins": [
    { "id": "file-parser", "pdf": { "engine": "mistral-ocr" } }
  ]
}

Исправление ответов (response-healing)

Плагин response-healing автоматически исправляет невалидный JSON в ответах моделей. Полезен при использовании response_format с json_schema.

Параметры

Параметр	Тип	Описание
`enabled`	boolean	Включить/выключить плагин

Пример

{
  "model": "openai/gpt-4o",
  "plugins": [
    { "id": "response-healing" }
  ],
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "result",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {
          "answer": { "type": "string" }
        },
        "required": ["answer"],
        "additionalProperties": false
      }
    }
  }
}

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

Поиск в интернете

Подробный гайд по веб-поиску для любой модели

Tool Calling

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

Структурный вывод

Получение структурированных данных

Начало работы

Продвинутое

Генерация медиа

Интеграции

Доступные плагины

Подключение плагинов

Несколько плагинов

Отключение плагина

Поиск в интернете (web)

Парсинг файлов (file-parser)

Параметры

Движки обработки PDF

Пример

Исправление ответов (response-healing)

Параметры

Пример

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

Поиск в интернете

Tool Calling

Структурный вывод

​Доступные плагины

​Подключение плагинов

​Несколько плагинов

​Отключение плагина

​Поиск в интернете (web)

​Парсинг файлов (file-parser)

​Параметры

​Движки обработки PDF

​Пример

​Исправление ответов (response-healing)

​Параметры

​Пример

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

Поиск в интернете

Tool Calling

Структурный вывод

Доступные плагины

Подключение плагинов

Несколько плагинов

Отключение плагина

Поиск в интернете (web)

Парсинг файлов (file-parser)

Параметры

Движки обработки PDF

Пример

Исправление ответов (response-healing)

Параметры

Пример

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