Плагины

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

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

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

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

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

import OpenAI from 'openai'

const openai = new OpenAI({
  baseURL: 'https://api.usellm.ru/v1',
  apiKey: '<USELLM_API_KEY>'
})

const completion = await openai.chat.completions.create({
  model: 'openai/gpt-6-astra',
  messages: [
    { role: 'user', content: 'Какие последние новости в сфере AI?' }
  ],
  // @ts-ignore — plugins не входит в типы OpenAI SDK
  plugins: [
    { id: 'web' }
  ]
})

from openai import OpenAI

client = OpenAI(
    base_url="https://api.usellm.ru/v1",
    api_key="<USELLM_API_KEY>"
)

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

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

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

{
  "model": "openai/gpt-6-astra",
  "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-6, Claude, Gemini.

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

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

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

Параметры

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

Пример

{
  "model": "openai/gpt-6-astra",
  "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.

Параметры

Пример

{
  "model": "openai/gpt-6-astra",
  "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
      }
    }
  }
}

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