工具
概览
xAI API 支持 工具调用,使 Grok 能够执行文本生成之外的操作,例如搜索网络、执行代码、查询数据或调用自定义函数。工具扩展了 API 的能力边界,可用于构建强大且具有交互性的应用。
工具类型
xAI API 提供两类工具:
| 类型 | 说明 | 示例 |
|---|---|---|
| 内置工具 | 由 xAI 管理并自动执行的服务端工具 | Web Search、X Search、Code Interpreter、Image Generation、Collections Search |
| 函数调用 | 由你定义、可供模型调用的自定义函数 | 数据库查询、API 调用、自定义业务逻辑 |
内置工具在 xAI 服务器上运行;你提供工具配置,API 负责执行并返回结果。函数调用允许你定义模型可以请求的工具,从而完全控制工具被调用时发生的操作。
定价
工具请求的价格由两部分组成:token 用量 和 工具调用次数。由于模型可能调用多个工具来回答查询,费用会随复杂度增加。
有关 Tool 定价的更多信息,请查看 定价页面。
工作原理
在请求中提供工具后,xAI API 可以使用这些工具收集信息或执行操作:
分析查询,确定需要哪些信息或操作
决定下一步操作:发起工具调用,或提供最终答案
执行工具(对于内置工具),或返回工具调用请求(对于函数调用)
处理结果,并持续执行直到收集到足够信息
返回最终响应,并在适用时提供引用
快速入门
curl https://api.x.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $XAI_API_KEY" \
-d '{
"model": "grok-4.7",
"stream": true,
"input": [
{
"role": "user",
"content": "What are the latest updates from xAI?"
}
],
"tools": [
{ "type": "web_search" },
{ "type": "x_search" },
{ "type": "code_interpreter" }
]
}'Citation
API 会自动返回通过 tool 收集的信息所对应的 source URL。有关访问和使用 citation data 的详情,请参阅 Citation。
下一步
函数调用,定义模型可以调用的 custom tool
Web Search,搜索 Web 并浏览页面
X Search,搜索 X 帖子、用户和 thread
Code Execution,在 sandbox 中执行 Python 代码
Image Generation,在 conversation 中生成和编辑图像
Collections Search,查询已上传文档
Citation,访问 source URL 和 inline citation
最后更新:2026 年 7 月 13 日