Плагины для chat completions

Используйте plugins в /v1/chat/completions, когда одному запросу нужен web grounding, явный выбор PDF engine, server-side response healing для structured output или санитизация секретов до запуска модели.

Добавьте плагин в запрос

Добавьте одну запись в plugins. Остальная часть запроса остаётся обычным chat-completions вызовом.

{
  "model": "qwen/qwen3-235b-a22b-instruct-2507-fp8",
  "messages": [
    {
      "role": "user",
      "content": "Summarize this incident note, but hide apiKey=sk-live-demo-123456."
    }
  ],
  "plugins": [
    {
      "id": "privacy-sanitization",
      "mode": "redact"
    }
  ]
}

• web: добавьте { "id": "web" }. Этот плагин включается только явно.
• file-parser: добавляйте pdf.engine только если запрос должен принудительно использовать pdf-text или native.
• response-healing: дополнительно передайте stream: false и structured response_format.
• privacy-sanitization: дополнительно передайте mode со значением redact, tokenize или block.

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

Как работает активация

• plugins в запросе — это обычный путь активации для /v1/chat/completions.
• Аутентифицированные API-запросы при включённой plugin settings policy также могут наследовать сохранённые plugin defaults.
• web по-прежнему требует явного opt-in в каждом запросе.
• file-parser всё ещё может применяться автоматически для PDF-входов, если достаточно server-managed выбора engine.

Ограничения и совместимость

• web и privacy-sanitization нельзя запускать в одном и том же запросе.
• response-healing работает только с stream: false и response_format.type, равным json_object или json_schema.
• web поддерживает streaming и non-streaming запросы.
• privacy-sanitization поддерживает streaming и non-streaming запросы.

См. также

• Web Search для явного built-in web grounding.
• PDF Inputs для file-parser, различий между pdf-text и native и PDF-specific ограничений.
• Response Healing для non-stream починки structured output.
• Privacy Sanitization для request-level санитизации секретов.
• Structured Outputs, если реальная задача — это JSON-контракт, а не выбор плагина.
• Tool Calling, если retrieval или tool execution должно жить на стороне приложения.
• Справочник Chat Completions API для точной схемы поля plugins.