Web Search

Enable web search per request with plugins: [{ "id": "web" }]. The model: "...:online" suffix is also accepted for OpenRouter compatibility, but new GonkaGate integrations should prefer the explicit plugin object.

Minimal request

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

When engine is omitted, gonka-proxy uses the saved Web Search provider for the authenticated account when plugin settings policy is enabled, otherwise it uses the server default.

Choose the saved provider

Web Search supports two saved providers: exa and perplexity. Choose one in the Dashboard Web Search settings, or update the setting through the dashboard API:

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

• provider: "exa" uses Exa for the web-search operation.
• provider: "perplexity" uses Perplexity for the web-search operation.
• config: {} clears the saved provider and returns the account to server-managed default selection.
• The saved provider does not enable web search by itself. The request still needs plugins: [{ "id": "web" }] or the :online model suffix.
• Keep request-level engine omitted unless you specifically need the OpenRouter-compatible exa hint. Public request bodies should not use engine: "perplexity".

Optional fields

{
  "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: requested result count. The server may cap it to a safe maximum.
• search_prompt: grounding prompt override used when formatting retrieved web results for the model.
• engine: OpenRouter-compatible engine hint. Unsupported values are rejected.
• enabled: false: disables web search when a web plugin object is present.

Compatibility

• Web search works for streaming and non-streaming chat completions.
• web is explicit opt-in only. Authenticated saved plugin defaults can choose the provider, but do not enable web search automatically.
• Do not combine web with privacy-sanitization; that request fails with HTTP 400 and code web_search_privacy_sanitization_not_supported.
• web_search_options is accepted for OpenRouter migration compatibility and is currently ignored in v1.

:online shorthand

This request is equivalent explicit opt-in:

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

Use the base model ID from GET /v1/models; append :online only at request time when you intentionally want web grounding.

Related pages

• Chat Completions Plugins for plugin selection and compatibility.
• Privacy Sanitization Plugin for the incompatible secret-sanitization path.
• Chat Completions API reference for the full request schema.