工具

概览

查看 Markdown

xAI API 支持 工具调用,使 Grok 能够执行文本生成之外的操作,例如搜索网络、执行代码、查询数据或调用自定义函数。工具扩展了 API 的能力边界,可用于构建强大且具有交互性的应用。

工具类型

xAI API 提供两类工具:

类型说明示例
内置工具由 xAI 管理并自动执行的服务端工具Web Search、X Search、Code Interpreter、Image Generation、Collections Search
函数调用由你定义、可供模型调用的自定义函数数据库查询、API 调用、自定义业务逻辑

内置工具在 xAI 服务器上运行;你提供工具配置,API 负责执行并返回结果。函数调用允许你定义模型可以请求的工具,从而完全控制工具被调用时发生的操作。

定价

工具请求的价格由两部分组成:token 用量工具调用次数。由于模型可能调用多个工具来回答查询,费用会随复杂度增加。

有关 Tool 定价的更多信息,请查看 定价页面


工作原理

在请求中提供工具后,xAI API 可以使用这些工具收集信息或执行操作:

  1. 分析查询,确定需要哪些信息或操作

  2. 决定下一步操作:发起工具调用,或提供最终答案

  3. 执行工具(对于内置工具),或返回工具调用请求(对于函数调用)

  4. 处理结果,并持续执行直到收集到足够信息

  5. 返回最终响应,并在适用时提供引用


快速入门

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


下一步


最后更新:2026 年 7 月 13 日