FlowModels

Ativar a busca na web, limitar a domínios e ler as fontes

Publicado em 11. novembro 2026

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 com 400 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 modelo
  • search_results: para cada fonte, title, url e date
"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_model em web_search: o modelo não tem busca própria, ou sempre pesquisa e você enviou false. Verifique web_search e web_search_forced na lista de modelos.
  • 400 em search_domain_filter: verifique se você misturou permissões e exclusões, informou https:// ou um caminho, ou enviou domínios demais.
  • Sem citations na resposta: o modelo decidiu que não precisava pesquisar para essa pergunta. Formule a pergunta de forma mais concreta ou limite os domínios.

Este artigo foi útil?

Voltar para Modelos, limites e erros