Um modelo de linguagem conhece apenas o que estava nos dados de treinamento dele. Para preços atuais, horários de funcionamento ou notícias, você pode ativar a busca na web do provedor. O modelo pesquisa na web por conta própria e entrega também as fontes. No FlowModels, a busca na web vem desativada por padrão, porque cada busca é cobrada à parte.
Ativar a busca na web
Na requisição, defina web_search como true. Isso funciona em /chat/completions e em /responses:
{
"model": "xai/grok-4.7",
"web_search": true,
"messages": [{"role": "user", "content": "Quais são os feriados em dezembro em Hamburgo?"}]
}
O identificador do modelo aqui é apenas um exemplo. Nem todo modelo tem busca na web própria. Em GET /v1/models, você vê em capabilities:
web_search: true: o modelo pode pesquisar quando você ativa.web_search_forced: true: o modelo sempre pesquisa, a busca é embutida. Isso vale, por exemplo, para os modelos da Perplexity.
Um modelo sem busca na web recusa web_search: true com 400 unsupported_for_model. Inversamente, um modelo com busca embutida recusa web_search: false, para que você não ache que a busca está desligada enquanto ela continua sendo cobrada.
Se você usa a biblioteca da OpenAI para Python, envie web_search e search_domain_filter por extra_body, veja Usar a biblioteca da OpenAI para Python e Node.js com o FlowModels.
Limitar a busca a domínios específicos
Com search_domain_filter, você controla onde a busca acontece. O campo também ativa a busca na web automaticamente.
- Apenas determinados sites:
"search_domain_filter": ["sua-empresa.com.br", "ajuda.sua-empresa.com.br"] - Excluir determinados sites:
"search_domain_filter": ["-reddit.com", "-pinterest.com"]
Valem algumas regras:
- Só permissões ou só exclusões, sem misturar.
- Informe os domínios sem
https://e sem caminho. Subdomínios são incluídos automaticamente. - No máximo 20 domínios. Alguns modelos aceitam menos, na xAI são 5. O número exato aparece em
capabilities.web_search_domain_filter_max. - Se ali constar
0, o modelo não aceita filtro de domínio. É o caso do Gemini, por exemplo. A requisição é então recusada com400 unsupported_for_model.
Um uso típico é um bot de ajuda que só deve consultar o seu próprio site.
Ler as fontes
Se o modelo pesquisou, a resposta contém dois campos adicionais:
citations: uma lista dos endereços usados pelo modelosearch_results: para cada fonte,title,urledate
"citations": ["https://www.example.de/feiertage-hamburg"],
"search_results": [{"title": "Feriados em Hamburgo", "url": "https://www.example.de/feiertage-hamburg", "date": "2026-10-02"}]
No streaming, os dois campos ficam no último chunk antes de [DONE]. Sem busca, eles não aparecem. O ideal é mostrar as fontes aos seus usuários, para que eles possam verificar as informações.
Quanto custa a busca
A busca é cobrada além dos tokens. O valor total de uma requisição aparece na resposta em usage.cost e no registro de requisições. Mais sobre o custo de uma requisição em Quanto custou minha requisição?
Quando algo não funciona
400 unsupported_for_modelemweb_search: o modelo não tem busca própria, ou sempre pesquisa e você envioufalse. Verifiqueweb_searcheweb_search_forcedna lista de modelos.400emsearch_domain_filter: verifique se você misturou permissões e exclusões, informouhttps://ou um caminho, ou enviou domínios demais.- Sem
citationsna resposta: o modelo decidiu que não precisava pesquisar para essa pergunta. Formule a pergunta de forma mais concreta ou limite os domínios.