xAI 文档

外观

发布说明 ​

发布说明 ​

七月 ​

grok-imagine-video-1.5 模态 ​

grok-imagine-video-1.5 现已支持文本生成视频、图像生成视频和参考生成视频（包括可选预设语音），T2V 和 I2V 原生支持 1080p 分辨率。请参阅 视频生成、图像生成视频 和 参考生成视频。

Grok Voice Think Fast 2.0 已发布 ​

grok-voice-think-fast-2.0 现已支持语音转语音功能。从 2026 年 8 月 5 日起，grok-voice-latest 将路由到此模型。开始使用，请参阅 语音转语音文档。更多详情，请查看我们的公告。

语音转文本可调整 VAD 阈值 ​

语音转文本现在接受 vad_threshold 参数（流式查询参数和批量多部分字段）来调整语音活动门限，跳过非语音音频。较低值可转录较安静或嘈杂的语音——对窄带电话很有用——0 则禁用该门限。请参阅 语音转文本文档。

Grok 4.5 在欧盟地区可用 ​

Grok 4.5 现已在欧盟用户的 API 控制台中可用。请参阅 Grok 4.5 概述。

Grok 4.5 ​

Grok 4.5，SpaceXAI 的编码、智能体任务和知识工作模型，现已在 xAI API 上可用。定价为 $2/100万输入令牌和 $6/100万输出令牌，可配置推理努力程度（低、中或高；默认为高）。请参阅 Grok 4.5 概述 和 公告。

六月 ​

优先处理 ​

您现在可以通过在文本推理端点（聊天补全和响应）上设置 service_tier: "priority" 来请求更高的调度优先级。响应的 service_tier 字段报告实际应用的层级，优先级费率仅在优先级被使用时计费。更多详情，请参阅 优先处理文档。

公共 URL 和文件 API ↔ Imagine 集成 ​

  • 文件的公共 URL — 将您 文件 API 存储中的任何文件转换为永久的、无需认证的 URL，任何人都可以打开、嵌入或分享。可在任何时间撤销，或设置 1 小时到 30 天的自动过期时间。请参阅 公共 URL 文档。
  • 将存储的文件作为 Imagine 输入引用 — 在所有 Imagine 端点中，用 image_file_id、video_file_id 或 reference_image_file_ids 替换 URL 输入，无需重新上传字节或将文件设为公开。请参阅 Imagine → 文件 API 集成。
  • 将 Imagine 输出保存到文件 — 在任何 Imagine 请求上设置 storage_options 以将生成的资源保存到您的文件存储中；与 storage_options.public_url 配对可在一次往返中发布可分享的链接。请参阅 Imagine → 文件 API 集成。

五月 ​

流式 STT 智能轮转 ​

流式语音转文本 API 现已支持智能轮转结束检测。通过 smart_turn 查询参数启用后，机器学习模型会在静音边界预测说话人是否已完成思考——减少听写、数字序列和句子中间停顿时的错误结束检测。使用 smart_turn_timeout 设置最大静音回退时间。更多详情，请参阅 智能轮转文档。

上下文压缩 ​

上下文压缩 API 现已可用。您可以将长对话压缩为更短的上下文，并在后续请求中重复使用，以降低成本、加快首个令牌生成时间，并在长智能体循环中获得更清晰的响应。更多详情，请参阅 上下文压缩文档。

WebSocket 响应 API 模式 ​

WebSocket 响应 API 模式现已可用。通过单个长期存在的 WebSocket 连接驱动响应 API，在工具密集型智能体工作负载中降低端到端延迟。更多详情，请参阅 WebSocket 模式文档。

网络搜索中的图像搜索 ​

网络搜索现在支持明确搜索图像。启用 enable_image_search 让 Grok 直接搜索相关图像；响应可以包含作为 Markdown 图像嵌入的返回图像。详情请参阅 启用图像搜索。

Grok Build 0.1 ​

xAI 的编码模型，专门为智能体编码工作流训练。目前处于早期访问阶段。

模型标识符为 grok-build-0.1。

Grok Build ​

Grok Build 现已提供 beta 版。使用交互式 TUI，在脚本中无头运行，或使用智能体客户端协议构建应用和编排器。

通过单个命令安装：

bash
curl -fsSL https://x.ai/cli/install.sh | bash

更多详情，请参阅 Grok Build 文档。

自定义语音 ​

您现在可以从简短音频片段中克隆语音，并在文本转语音和语音转语音 API 中使用。从 xAI 控制台创建和管理您的语音目录。更多详情，请查看 自定义语音文档 和我们的 博客文章。

四月 ​

成本跟踪 ​

每个 API 响应现在通过 usage 对象中的 cost_in_usd_ticks 字段包含请求的确切成本。适用于聊天补全、响应 API、图像生成、视频生成和流式处理。更多详情，请参阅 成本跟踪文档。

文件 API TTL ​

您现在可以使用 expires_after 或明确的 expires_at 时间戳为上传的文件设置过期策略。过期文件会自动删除。更多详情，请参阅 文件 API 文档。

Grok Voice Think Fast 1.0 已发布 ​

您现在可以在语音转语音 API 中使用 grok-voice-think-fast-1.0。开始使用，请查看 语音转语音文档。更多详情，请查看我们的 博客文章。

语音转文本已发布 ​

xAI 语音转文本 API 现已正式发布。支持 25 种语言的音频转录，提供批量处理和流式模式。更多详情，请查看 语音转文本文档。

三月 ​

文本转语音已发布 ​

文本转语音 API 现已正式发布。使用 Grok 从文本生成自然的语音。更多详情，请查看 文本转语音文档。

批量 API 支持图像和视频生成 ​

批量 API 现在除了聊天补全外，还支持 图像生成、图像编辑 和 视频生成。服务器端工具 和客户端函数工具现在也支持批量请求。批量结果中的图像和视频 URL 在 1 小时后过期。

批量 API JSONL 文件上传 ​

您现在可以通过文件 API 上传 JSONL 文件 来创建批量处理。单个文件支持所有批量端点，包括聊天、图像和视频。

Grok 4.20 和 Grok 4.20 多智能体已上线 ​

  • 有关 Grok 4.20 多智能体的更多详情，请查看 文档

一月 ​

视频生成与下一代图像生成 ​

视频生成 和重新设计的 图像生成 现已可用。

批量 API 已发布 ​

批量 API 对所有客户可用。它支持高效处理多个请求，为需要一次提交大量请求的用户提供更好的体验。

2025年12月 ​

Grok 语音转语音 API 已发布 ​

Grok 语音转语音 API 已正式发布。访问 Grok 语音转语音 API 获取使用指南。

2025年11月 ​

Grok 4.1 Fast 在企业 API 中可用 ​

您现在可以在 xAI 企业 API 中使用 Grok 4.1 Fast。更多详情，请查看 我们的博客文章。

智能体工具适配 Grok 4.1 Fast 模型且工具价格降低 ​

  • 您现在可以在智能体工具中使用 Grok 4.1 Fast 模型，查看 智能体工具文档 开始使用。
  • 智能体工具价格降低最多 50%，不超过每 1000 次成功调用 $5，新价格请查看 定价页面。

文件 API 正式发布 ​

您现在可以使用文件 API 上传文件并在聊天对话中使用它们。更多详情，请查看 我们的文件指南。

新工具可用 ​

  • 集合搜索工具：您现在可以通过 API 在聊天对话中搜索上传的知识库（集合）。更多详情，请查看 文档。
  • 远程 MCP 工具：您现在可以通过 API 在聊天对话中使用来自远程 MCP 服务器的工具。更多详情，请查看 文档。
  • 混合客户端和服务器端工具：您现在可以在同一聊天对话中混合使用客户端和服务器端工具。更多详情，请查看 文档。

2025年10月 ​

工具现已正式发布 ​

新的智能体服务器端工具，包括 web_search、x_search 和 code_execution 现已可用。更多详情，请查看 我们的工具使用指南。

2025年9月 ​

响应 API 正式发布 ​

您现在可以使用我们的有状态响应 API 来处理请求。

2025年8月 ​

集合 API 已发布 ​

您可以使用集合 API 上传文件、创建嵌入，并用于推理。

2025年7月 ​

Grok 4 已发布 ​

您现在可以通过我们的 API 或在 https://grok.com 上使用 Grok 4。

2025年6月 ​

管理 API 已发布 ​

您可以通过管理 API 在 https://management-api.x.ai 管理您的 API 密钥。

2025年5月 ​

缓存提示现已可用 ​

您现在可以使用缓存提示来节省重复提示的成本。更多 信息，请参阅 模型。

实时搜索在 API 上可用 ​

实时搜索现在在 API 上可用。用户可以 在支持的数据源上生成查询的补全。

2025年4月 ​

Grok 3 模型在 API 上发布 ​

我们最新的旗舰 Grok 3 模型现在通过 API 正式发布。更多信息，请参阅 模型。

2025年3月 ​

图像生成模型在 API 上可用 ​

图像生成模型现在在 API 上可用。访问 图像生成 了解使用该模型的更多详情。

2025年2月 ​

审计日志 ​

团队管理员现在可以在 console.x.ai 查看审计日志。

2025年1月 ​

文档暗黑模式 ​

在 docs.x.ai 上发布了暗黑模式支持

状态页面 ​

在 status.x.ai 查看所有 SpaceXAI 产品的服务状态。

2024年12月 ​

Replit & xAI ​

Replit 智能体现在可以与 xAI 集成！开始使用 Grok 增强您的智能体。 更多信息，请查看 公告。

令牌化工具 ​

理解令牌可能很困难。访问 console.x.ai 以更好地了解什么算作令牌。

结构化输出 ​

我们很高兴地宣布，Grok 现在支持结构化输出。Grok 可以 按照预定义的、有组织的格式而非自由文本格式化响应。1. 指定 所需的架构

{
    "name": "movie_response",
    "schema": {
        "type": "object",
        "properties": {
            "title": { "type": "string" },
            "rating": { "type": "number" }
        },
        "required": [ "title", "rating" ],
        "additionalProperties": false
    },
    "strict": true
}
  1. 获取所需的数据
{
  "title": "Star Wars",
  "rating": 8.6
}

开始构建更可靠的应用程序。更多信息，请参阅 文档。

发布新的 grok-2-1212 和 grok-2-vision-1212 模型 ​

一个月前，我们发布了企业 API 的公开 测试版，包含 grok-beta 和 grok-vision-beta。我们添加了 grok-2-1212 和 grok-2-vision-1212，提供更高的准确性、指令遵循能力和多语言功能。

2024年11月 ​

LangChain & xAI ​

我们的 API 现在可通过 LangChain 使用！

您要构建什么？

API 公开测试版 ​

我们很高兴地宣布，我们的 API 现已 立即可用，为开发者提供对我们 Grok 系列基础模型的编程访问。开始使用，请前往 console.x.ai 注册创建账户。我们很期待看到开发者使用 Grok 构建什么。

本文档为 docs.x.ai 全站中文翻译，由 AI 自动翻译生成。代码示例请以原文为准。

xAI 文档中文版 · 仅供学习参考