工具名称:web_search
费用:$5 / 1K 次调用
Grok 除了训练数据中的内容外,不了解当前事件或数据。要整合实时数据, 请启用网络搜索工具。模型会自主决定何时搜索网络以获取最新信息。
基本用法
Python (OpenAI)
from openai import OpenAI
client = OpenAI(api_key=os.getenv("XAI_API_KEY"), base_url="https://api.x.ai/v1")
response = client.responses.create(
model="grok-4.5",
input="2026年最新的AI新闻有哪些?",
tools=[{"type": "web_search"}],
)
print(response.output_text)图像理解
网络搜索支持图像理解功能。启用后,模型可以分析搜索中发现的图像。 图像理解按 token 计费,工具名称为 view_image。
搜索结果
搜索结果会自动整合到模型响应中。模型会引用来源并在回答中标注。 搜索结果包含网页标题、URL 和摘要内容。
最佳实践
- 仅在需要实时信息时启用搜索工具
- 明确告诉模型你想要搜索什么类型的信息
- 搜索结果会增加 token 使用量,注意控制成本
- 结合 X 搜索获取社交媒体上的实时信息