API Console

发布说明

发布说明

查看 Markdown
创建 API Key 了解 Grok 4.5

七月

grok-imagine-video-1.5 modalities

grok-imagine-video-1.5 现在支持 text-to-video、image-to-video 和 reference-to-video（包括可选的预设声音），并为 T2V 和 I2V 提供原生 1080p。请参阅视频生成、Image-to-Video和Reference-to-Video。

Grok Voice Think Fast 2.0 已可用

grok-voice-think-fast-2.0 现在可用于 Speech to Speech。自 2026 年 8 月 5 日起，grok-voice-latest 将路由到此模型。请参阅 Speech to Speech 文档开始使用。更多信息请参阅我们的公告。

Speech to Text 支持调整 VAD threshold

Speech to Text 现在接受 vad_threshold 参数（streaming query param 和 batch multipart field），用于调整跳过非语音音频的 voice-activity gate。较低的值可以转录更轻或噪声更大的语音，这对窄带电话非常有用；设置为 0 会禁用该 gate。请参阅 Speech to Text 文档。

Grok 4.5 已在欧盟可用

欧盟用户现在可以在 API console 中使用 Grok 4.5。请参阅 Grok 4.5 概览。

Grok 4.5

Grok 4.5 是 SpaceXAI 面向编程、Agent 任务和知识工作的模型，现已在 xAI API 上可用。价格为每 1M 输入 tokens $2、每 1M 输出 tokens $6，并支持可配置的 reasoning effort（低、中、高，默认为高）。请参阅 Grok 4.5 概览和发布公告。

六月

Priority Processing

现在可以在文本推理 endpoint（Chat Completions 和 Responses）上设置 service_tier: "priority"，为单个请求申请更高的调度优先级。响应中的 service_tier field 会报告实际应用的 tier，并且只有实际使用 priority 时才按 priority 费率计费。更多信息请参阅 Priority Processing 文档。

Public URLs 与 Files API ↔ Imagine 集成

  • Files 的 Public URLs — 将 Files API 存储中的任何文件转为永久、无需身份验证的 URL，任何人都可以打开、嵌入或分享。可随时撤销，也可以设置 1 小时至 30 天的自动过期时间。请参阅 Public URLs 文档。

  • 将已存储文件作为 Imagine 输入引用 — 在所有 Imagine endpoint 中使用 image_file_id、video_file_id 或 reference_image_file_ids 替代 URL 输入，无需重新上传字节或公开文件。请参阅 Imagine → Files API Integration。

  • 将 Imagine 输出持久化到 Files — 在任意 Imagine 请求上设置 storage_options，把生成的资产保存到 Files 存储；与 storage_options.public_url 配合，可在一次往返中发布可分享链接。请参阅 Imagine → Files API Integration。

五月

Streaming STT 的 Smart Turn

Streaming Speech to Text API 现在支持 Smart Turn 轮次结束检测。通过 smart_turn query parameter 启用后，ML 模型会在静音边界预测说话者是否已经表达完毕，从而减少听写、数字序列和句中停顿时的错误截断。使用 smart_turn_timeout 设置最大静音 fallback。更多信息请参阅 Smart Turn 文档。

Context Compaction

Context Compaction API 现已可用。你可以将长对话压缩成更短的上下文，并在后续请求中复用，从而降低成本、缩短首 token 时间，并让长 Agent 循环中的响应更加精准。更多信息请参阅 Context Compaction 文档。

WebSocket Responses API Mode

WebSocket Responses API mode 现已可用。通过一个长期保持的 WebSocket 连接驱动 Responses API，可降低工具密集型 Agent 工作负载的端到端延迟。更多信息请参阅 WebSocket Mode 文档。

Web Search 现在支持显式搜索图像。启用 enable_image_search 后，Grok 可以直接搜索相关图像，响应可以通过 Markdown image embed 返回图像。详情请参阅启用 Image Search。

Grok Build 0.1

xAI 面向 Agent 编程工作流专门训练的编程模型，目前处于 early access。

模型 slug 为 grok-build-0.1。

Grok Build

Grok Build beta 版现已可用。你可以使用交互式 TUI、在脚本中以 headless 方式运行，或通过 Agent Client Protocol 构建应用和 orchestrator。

使用一条命令安装：

Bash

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

更多信息请参阅 Grok Build 文档。

Custom Voices

现在可以使用短音频片段克隆声音，并在 Text-to-Speech 和 Speech to Speech API 中使用。可以从 xAI console 创建和管理声音目录。更多信息请查看 Custom Voices 文档和我们的博客文章。

四月

Cost Tracking

每个 API 响应现在都会通过 cost_in_usd_ticks field 提供该请求的准确成本，该 field 位于 usage object 中。适用于 chat completions、Responses API、图像生成、视频生成和 streaming。更多信息请参阅 Cost Tracking 文档。

Files API TTL

现在可以使用 expires_after 或显式 expires_at timestamp 为上传的文件设置过期策略。过期文件会自动删除。更多信息请参阅 Files API 文档。

Grok Voice Think Fast 1.0 已可用

现在可以在 Speech to Speech API 中使用 grok-voice-think-fast-1.0。请查看 Speech to Speech 文档开始使用。更多信息请参阅我们的博客文章。

Speech to Text 已可用

xAI Speech to Text API 现已全面可用，支持以 batch 和 streaming 模式转录 25 种语言。更多信息请查看 Speech to Text 文档。

三月

Text-to-Speech 已可用

Text-to-Speech API 现已全面可用。使用 Grok 根据文本生成自然语音。更多信息请查看 Text-to-Speech 文档。

Batch API 支持图像和视频生成

Batch API 现在除了 chat completions 外，还支持图像生成、图像编辑和视频生成。同时也支持服务器端工具和客户端 function tools。Batch 结果中的图像和视频 URL 会在 1 小时后过期。

Batch API JSONL 文件上传

现在可以通过 Files API 上传 JSONL 文件来创建 batch。在一个文件中支持 chat、image 和 video 等所有 batch endpoint。

Grok 4.20 和 Grok 4.20 Multi-agent 已上线

  • 有关 Grok 4.20 Multi-agent 的更多信息，请查看文档

一月

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

视频生成和全新升级的图像生成现已可用。

Batch API 已发布

Batch API 已向所有客户开放。它可以高效地批量处理多个请求，为需要提交大量请求的用户提供更好的体验。

2025 年 12 月

Grok Speech to Speech API 已发布

Grok Speech to Speech API 现已全面可用。请访问 Grok Speech to Speech API了解如何使用该 API。

2025 年 11 月

Enterprise API 已支持 Grok 4.1 Fast

现在可以在 xAI Enterprise API 中使用 Grok 4.1 Fast。更多信息请查看我们的博客文章。

Agent tools 适配 Grok 4.1 Fast 模型，工具价格下降

  • 现在可以将 Grok 4.1 Fast 模型与 Agent tools 配合使用，请查看 Agent tools 文档开始使用。

  • Agent tools 价格最高下降 50%，每 1000 次成功调用不超过 $5；新价格请查看价格页面。

Files API 已全面可用

现在可以使用 Files API 上传文件并在 chat 对话中使用。更多信息请查看我们的 Files 指南。

新工具上线

  • Collections Search Tool：现在可以通过 API 在 chat 对话中搜索已上传的知识库（collections）。更多信息请查看文档。

  • Remote MCP Tools：现在可以在 chat 对话中使用来自 remote MCP server 的工具。更多信息请查看文档。

  • 混合客户端与服务器端工具：现在可以在同一 chat 对话中混合客户端与服务器端工具。更多信息请查看文档。

2025 年 10 月

Tools 已全面可用

包括 web_search、x_search 和 code_execution 在内的全新 Agent 服务器端工具现已可用。更多信息请查看我们的 Tools 使用指南。

2025 年 9 月

Responses API 已全面可用

现在可以使用有状态的 Responses API 处理请求。

2025 年 8 月

Collections API 已发布

你可以上传文件、创建 embedding，并通过 Collections API 将其用于推理。

2025 年 7 月

Grok 4 已发布

现在可以通过 API 或 https://grok.com 使用 Grok 4。

2025 年 6 月

Management API 已发布

可以通过 Management API 管理 API key，地址为 https://management-api.x.ai。

2025 年 5 月

Cached prompt 现已可用

现在可以使用 cached prompt 节省重复提示词的成本。更多信息请参阅模型。

API 支持 Live Search

Live search 现已在 API 上可用。用户可以使用受支持数据源中的 query 生成 completion。

2025 年 4 月

Grok 3 模型在 API 上发布

我们最新的旗舰 Grok 3 模型现已通过 API 全面提供。更多信息请参阅模型。

2025 年 3 月

API 支持图像生成模型

图像生成模型现已在 API 上可用。有关该模型的更多使用信息，请访问图像生成。

2025 年 2 月

Audit Logs

团队管理员现在可以在 console.x.ai 查看 audit log。

2025 年 1 月

Docs Dark Mode

文档站已支持暗黑模式。

Status Page

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

2024 年 12 月

Replit 与 xAI

Replit Agents 现在可以与 xAI 集成！开始用 Grok 增强你的 Agent。 请查看公告了解更多信息。

Tokenizer Playground

理解 token 并不容易。请查看 console.x.ai，更直观地了解哪些内容会计为 token。

Tokenizer example

Structured Outputs

我们很高兴地宣布 Grok 现在支持 structured outputs。Grok 现在可以按照预定义的有序格式返回响应，而不是自由格式文本。1. 指定 所需 schema

Text

{
    "name": "movie_response",
    "schema": {
        "type": "object",
        "properties": {
            "title": { "type": "string" },
            "rating": { "type": "number" }
        },
        "required": [ "title", "rating" ],
        "additionalProperties": false
    },
    "strict": true
}

  1. 获取所需数据

Text

{
  "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

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

你准备构建什么？

API Public Beta

我们很高兴宣布 API public beta 立即开放，让开发者能够以编程方式访问 Grok foundation model 系列。请前往 console.x.ai 注册账户并开始使用。我们期待看到开发者使用 Grok 构建的成果。