Web Search

Включайте web search отдельно для каждого запроса через plugins: [{ "id": "web" }]. Суффикс model: "...:online" тоже поддерживается для OpenRouter compatibility, но для новых интеграций GonkaGate предпочтительнее явный plugin object.

Минимальный запрос

{
  "model": "qwen/qwen3-235b-a22b-instruct-2507-fp8",
  "messages": [
    {
      "role": "user",
      "content": "What changed in the latest Gonka Network release?"
    }
  ],
  "plugins": [
    {
      "id": "web"
    }
  ]
}

Если engine не передан, gonka-proxy использует сохранённый Web Search provider аутентифицированного аккаунта, когда включена plugin settings policy, иначе использует server default.

Как выбрать сохранённого provider

Web Search поддерживает двух сохранённых providers: exa и perplexity. Выберите нужный вариант в настройках Web Search в Dashboard или обновите setting через dashboard API:

{
  "config": {
    "provider": "perplexity"
  }
}

• provider: "exa" использует Exa для web-search operation.
• provider: "perplexity" использует Perplexity для web-search operation.
• config: {} очищает сохранённого provider и возвращает аккаунт к server-managed default selection.
• Сохранённый provider сам по себе не включает web search. В запросе всё равно нужен plugins: [{ "id": "web" }] или суффикс модели :online.
• Оставляйте request-level engine пустым, если вам специально не нужен OpenRouter-compatible hint exa. В public request body не нужно передавать engine: "perplexity".

Дополнительные поля

{
  "model": "qwen/qwen3-235b-a22b-instruct-2507-fp8",
  "messages": [
    {
      "role": "user",
      "content": "Find recent sources and summarize the facts."
    }
  ],
  "plugins": [
    {
      "id": "web",
      "max_results": 5,
      "search_prompt": "Prefer primary sources and recent documentation."
    }
  ]
}

• max_results: запрошенное количество результатов. Сервер может ограничить его безопасным максимумом.
• search_prompt: grounding prompt override для форматирования найденных web results перед передачей модели.
• engine: OpenRouter-compatible engine hint. Неподдерживаемые значения отклоняются.
• enabled: false: отключает web search, когда объект web plugin присутствует в запросе.

Совместимость

• Web search работает для streaming и non-streaming chat completions.
• web включается только явно. Сохранённые plugin defaults могут выбрать provider, но не включают web search автоматически.
• Не комбинируйте web с privacy-sanitization; такой запрос возвращает HTTP 400 с кодом web_search_privacy_sanitization_not_supported.
• web_search_options принимается для OpenRouter migration compatibility и сейчас игнорируется в v1.

Shorthand :online

Этот запрос тоже явно включает web search:

{
  "model": "qwen/qwen3-235b-a22b-instruct-2507-fp8:online",
  "messages": [{ "role": "user", "content": "Find recent sources." }]
}

Берите базовый model ID из GET /v1/models; добавляйте :online только на уровне конкретного запроса, когда действительно нужен web grounding.

Связанные страницы

• Плагины для chat completions для выбора plugin path и проверки совместимости.
• Плагин Privacy Sanitization для несовместимого пути санитизации секретов.
• Справочник Chat Completions API для полной схемы запроса.