generateContent。
搜索费之外,模型读取的搜索结果按输入 token 计费,一次搜索通常会增加数千到上万输入 token。
联网请求比普通请求慢,一次通常要十几秒到一分钟,客户端超时建议设为 300 秒。
支持的模型
2026 年 10 月 14 日验证可用:
Chat Completions 的
web_search_options 参数不可用,会返回 400 Unknown parameter。已经基于 Chat Completions 开发的应用,把需要联网的请求改走 Responses。
GPT 与 Grok:Responses web_search
运行前安装 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 一次请求可能搜索多次,耗时和搜索费会相应增加。
Gemini:google_search
运行前安装 SDK(python -m pip install google-genai):
web_search_queries 里的搜索词个数计算。grounding_chunks 是模型引用的网页,uri 是 Google 的跳转链接,打开后到达原网页。
不用 SDK 时,直接发送 JSON:
在调用日志里核对搜索费
控制台「日志」中,带联网搜索的请求会显示「Web Search 工具调用 N 次」和对应额度;通过日志查询 API 读取时,在other 字段的 web_search_billing 里。总费用 = 搜索次数 × 单次价格 + token 费用。
常见问题
模型没有搜索就直接回答了?
工具只是”允许搜索”,由模型判断是否需要。问题本身需要最新信息时,模型通常会搜索;想提高搜索概率,在提示词里写明”请联网查询并给出来源”。能限制只搜某些网站吗?
可以在提示词里要求优先引用某些网站,但模型不保证只用这些来源。上线前用少量请求确认效果。Nano Banana 的 Google 搜索也是这个价格吗?
是。Nano Banana 图像模型开启 Google 搜索接地时,同样按每次 $0.014 另收,见 Nano Banana 2.1。相关文档
- 让模型调用你自己的函数:函数调用
- Responses 与 Chat Completions 的区别:OpenAI 模型接入
- Gemini 原生格式的完整字段:Gemini 原生协议
- 模型 token 单价:模型与价格总表
参考资料
- OpenAI:Web search 工具
- xAI:Search tools
- Google:Grounding with Google Search
- 老张API搜索费与 token 用量:控制台调用日志