Skip to main content
联网搜索是服务端工具:模型自己决定搜什么、搜几次,读完结果后给出带来源链接的回答,你的程序不需要执行任何函数。老张API按厂商的原生方式提供,GPT 和 Grok 用 Responses,Gemini 用原生 generateContent。 搜索费之外,模型读取的搜索结果按输入 token 计费,一次搜索通常会增加数千到上万输入 token。 联网请求比普通请求慢,一次通常要十几秒到一分钟,客户端超时建议设为 300 秒。

支持的模型

2026 年 10 月 14 日验证可用: Chat Completions 的 web_search_options 参数不可用,会返回 400 Unknown parameter。已经基于 Chat Completions 开发的应用,把需要联网的请求改走 Responses。 运行前安装 SDK(python -m pip install openai),并设置 LAOZHANG_API_KEY 环境变量。
response.output 里依次出现:
  • web_search_call:每次搜索一项,有几项就收几次搜索费
  • message:最终回答,annotations 里是 url_citation 来源
把 model 换成 grok-4.5 写法相同。grok-4.5 一次请求可能搜索多次,耗时和搜索费会相应增加。 运行前安装 SDK(python -m pip install google-genai):
搜索费按 web_search_queries 里的搜索词个数计算。grounding_chunks 是模型引用的网页,uri 是 Google 的跳转链接,打开后到达原网页。 不用 SDK 时,直接发送 JSON:
Gemini 的 OpenAI 兼容接口不支持这个工具,联网时请使用原生格式。

在调用日志里核对搜索费

控制台「日志」中,带联网搜索的请求会显示「Web Search 工具调用 N 次」和对应额度;通过日志查询 API 读取时,在 other 字段的 web_search_billing 里。总费用 = 搜索次数 × 单次价格 + token 费用。

常见问题

模型没有搜索就直接回答了?

工具只是”允许搜索”,由模型判断是否需要。问题本身需要最新信息时,模型通常会搜索;想提高搜索概率,在提示词里写明”请联网查询并给出来源”。

能限制只搜某些网站吗?

可以在提示词里要求优先引用某些网站,但模型不保证只用这些来源。上线前用少量请求确认效果。

Nano Banana 的 Google 搜索也是这个价格吗?

是。Nano Banana 图像模型开启 Google 搜索接地时,同样按每次 $0.014 另收,见 Nano Banana 2.1。

相关文档

参考资料