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.

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

{
  "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 в аккаунте не включают его автоматически.
• Не комбинируйте 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 reference для полной схемы запроса.