Web search

Add :online to a model id and it searches the web first, then answers with what it found:

{
  "model": "google/gemini-3.8-flash:online",
  "messages": [{ "role": "user", "content": "What happened on BNB Chain this week?" }],
  "max_tokens": 1024
}

What it costsCopy Anchor Link

Each search is charged at the model's search price, shown as web_search in GET /models, on top of the tokens. The search results are read as input.

While the call runs, it reserves five searches plus the tokens, and returns what it didn't use.

Search as a toolCopy Anchor Link

Models that support hosted web search and web fetch tools can use them too. They run in a loop, so set max_tool_calls to cap the steps and the reserve. X search is not served: it bills per post returned with no limit a request can set.