从写代码,到创作下一幕

探索 字节跳动 - 火山方舟 的 AI 编程与视频创作活动。

火山方舟 Agent Plan 与 Coding Plan 活动,价格 ¥9.9 起

Agent Plan & Coding Plan

一站体验多款热门模型,为 AI 编程与智能体开发提供更多选择。新用户可联系(微信: goo_lvyouyou)免费体验 9.9 agent plan。

查看套餐优惠
Seedance 2.5 视频创作活动:30 秒视频、多模态参考、局部编辑

Seedance 2.5

让创意,跃然成片。探索 30 秒视频、多模态参考与局部编辑,把脑海中的画面变成下一支作品。

探索视频创作

工具

概览

查看 Markdown

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

工具类型

xAI API 提供两类工具:

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

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

定价

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

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


工作原理

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

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

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

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

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

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


快速入门

import { xai } from '@ai-sdk/xai';
import { streamText } from 'ai';

const { fullStream } = streamText({
  model: xai.responses('grok-4.7'),
  prompt: 'What are the latest updates from SpaceXSI?',
  tools: {
    web_search: xai.tools.webSearch(),
    x_search: xai.tools.xSearch(),
    code_execution: xai.tools.codeExecution(),
  },
});

for await (const part of fullStream) {
  if (part.type === 'text-delta') {
    process.stdout.write(part.text);
  } else if (part.type === 'source' && part.sourceType === 'url') {
    console.log(`Citation: ${part.url}`);
  }
}

Citation

API 会自动返回通过 tool 收集的信息所对应的 source URL。有关访问和使用 citation data 的详情,请参阅 Citation。


下一步


最后更新:2026 年 10 月 10 日