工具让模型超越纯文本生成 — 它们可以搜索网络、查询 X 帖子、执行代码、调用自定义函数等。 使用 xAI 提供的服务端工具的请求基于两个组件计费：token 使用量和服务端工具调用。
可用工具
函数调用
定义自定义工具函数，让模型自动调用
网络搜索
搜索互联网并浏览网页 — $5 / 1K 次调用
X 搜索
搜索 X 帖子、用户资料和话题 — $5 / 1K 次调用
代码执行
在沙盒环境中运行 Python 代码 — $5 / 1K 次调用
工具调用费用
| 工具 | 工具名称 | 描述 | 费用 / 1K 次调用 |
|---|---|---|---|
| 网络搜索 | web_search | 搜索互联网并浏览网页 | $5 |
| X 搜索 | x_search | 搜索 X 帖子、用户资料和话题 | $5 |
| 代码执行 | code_execution | 在沙盒环境中运行 Python 代码 | $5 |
| 文件附件 | attachment_search | 搜索附加到消息的文件 | $10 |
| 集合搜索 (RAG) | collections_search | 查询上传的文档集合 | $2.50 |
| 图像理解 | view_image | 分析搜索中发现的图像 | 按 token 计费 |
| X 视频理解 | view_x_video | 分析 X 搜索中发现的视频 | 按 token 计费 |
| 远程 MCP 工具 | 由 MCP 服务器设置 | 连接和使用自定义 MCP 工具服务器 | 按 token 计费 |
注意：所有工具名称在 Responses API 中可用。在 gRPC API（Python xAI SDK）中，code_interpreter 和 file_search 不受支持。
Token 费用
所有标准 token 类型都按请求中使用的模型计费：
- 输入 tokens — 你的查询和对话历史
- 推理 tokens — 智能体的内部思考和规划
- 输出 tokens — 最终响应
- 图像 tokens — 视觉内容分析（如适用）
- 缓存提示 tokens — 从缓存提供而非重新计算的提示 tokens