They are partners: search finds the pages, fetch reads them. The calls never
appear in the message you receive — they are the router’s, not the model’s — but
they are reported alongside it on streamed responses as
tool activity chunks.
When they are on
Both are off unless you ask for them. A search is billed per call and fetched pages are re-sent on every later round, so neither is something to be opted into on your behalf. Turn them on per request:web_fetch on every
turn, and web_search according to the Search toggle in the composer —
on by default, remembered per browser. Turning it off is the difference between
an answer from what the model knows and an answer it may pay to look up.
The API defaults both off instead, because a program paying per request should
not inherit that cost without asking for it.
What it costs
Two separate costs, and the second is the one that surprises people: The search itself costs about $0.00875 per call, capped at 3 per request. The tokens are the larger bill. Each tool round sends the conversation, the tool definitions, and every result so far back upstream as input. A single production search turn metered 41,759 input tokens. At 0.04 in tokens against $0.009 in search fees.Why it is billed after the fact
Nothing knows whether a request will search until it does. Quoting up front for three searches that almost never happen would have charged every caller roughly thirty times what an ordinary chat turn costs. So tool spend is metered as it runs and billed at settlement instead — and a turn that lands above its quote books the difference as credit debt, collected on that payer’s next request. This is the one case where your bill can exceed what you were quoted. See How billing works.Leaving them off
They are off unless you ask, so a tight balance needs no action — costs track the quote most closely with both left alone.Controls and limits
- 3 searches per request, maximum. A turn that wants a fourth is answered with what it has.
- 5 upstream rounds per request. The last one is asked without the router’s tools, so a turn can search or fetch in at most four of them and the fifth has to answer with what it gathered. A model that keeps calling for more gets its answer returned rather than an error about the budget.
- 15-second timeout on each search and each fetch.
- 400 KB raw / 80,000 characters per fetched page, truncated past that.
- 5 redirects, each one re-validated.
web_fetch validates the target address inside the connection’s own DNS
lookup, so the address vetted is by construction the address connected to.
Private, loopback, and link-local addresses are refused — a model cannot be
talked into fetching your internal network.
Checking availability
web_search requires a search provider to be configured on the router. The live
answer is in GET /v1/models:
available is false, the tool is not injected at all — passing
"web_search": true will not enable it.