Some models search through their provider’s search service rather than a search of their own. Their answer has no
web_search_call item or server_tool_use block. The search shows in the sources, in the Web search calls line on the Logs page, and in Messages in usage.server_tool_use.web_search_requests.
Search depends on the provider
A request with the search tool goes first to the providers that can search for this model. If none of them can answer right now, or the model has no provider with search, NagaAI answers without searching instead of failing. Such an answer has noweb_search_call item or web_search_tool_result block, and it carries this response header:
tool_choice: "required" becomes "auto". Check for the header or for the search items before you rely on the answer being current. Retry later if you need a search.
A request that forces the search is never answered without it. In Responses that is tool_choice: {"type": "web_search"}, or allowed_tools with mode required and only the search. In Messages it is tool_choice: {"type": "tool", "name": "web_search"}. If the model has no provider with search, such a request fails with 400 invalid_request_error. If its providers with search can’t answer right now, it fails with 503, and you can retry.
A streamed answer with a search starts once the search is done, or after 15 seconds of searching. If the provider fails before the answer starts, NagaAI sends the request to another provider. The stream doesn’t end with an error.
To see which models can search, look for web_search in the parameters of the model’s operation in GET /v1/models.
Price
Each search costs 0.005 credits, $5 per 1,000 searches, on top of the answer’s tokens. The price is the same on every paid model. A search that fails costs nothing, and so does a model that answers without searching. Models whose id ends in:free don’t charge for search. The pages a search finds usually reach the model as input, so an answer with a search also uses more input tokens.
The search count is a line of its own, Web search calls, in How the cost was calculated on the Logs page. See Billing.
Options
Chat Completions acceptsweb_search_options with search_context_size and user_location. The model decides whether to search, as with the tool in the other formats, and tool_choice applies to the search too: "none" keeps the model from searching.
Responses accepts web_search with search_context_size, user_location, filters.allowed_domains, and the NagaAI additions max_uses, blocked_domains and external_web_access. The older web_search_preview type takes only search_context_size and user_location. Sending both allowed and blocked domains fails with 400.
Messages accepts web_search_20250305 and web_search_20260209 with max_uses, allowed_domains, blocked_domains and user_location, plus the NagaAI additions search_context_size and external_web_access.
Options the serving model cannot use have no effect, and no error is raised.