X 搜索

X 搜索工具让模型能够搜索 X（前 Twitter）上的帖子、用户资料和话题。 这对于获取社交媒体上的实时讨论、趋势话题和公众意见特别有用。

基本用法

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="在 X 上搜索关于 AI 最新进展的热门帖子",
    tools=[{"type": "x_search"}],
)

print(response.output_text)

视频理解

X 搜索支持视频理解功能。启用后，模型可以分析 X 搜索中发现的视频。 视频理解按 token 计费，工具名称为 view_x_video。

搜索范围

X 搜索可以搜索以下内容：

• 帖子 — 搜索 X 上的公开帖子
• 用户资料 — 搜索用户名和个人资料
• 话题 — 搜索热门话题和标签
• 对话线程 — 搜索完整的对话线程

最佳实践

• 结合网络搜索使用，获取更全面的信息
• 明确指定搜索关键词和时间范围
• X 搜索适合获取实时事件、公众舆论和趋势
• 注意 X 内容可能包含主观观点，需要模型进行判断