Grok API：密钥、端点、模型与第一个请求
开发者如何获得 Grok 模型的访问权限、应使用哪些端点和 SDK，以及当前模型阵容的价格。
Grok API 是 SpaceXSI（前身为 xAI）的付费开发者接口，地址为 https://api.x.ai/v1。你需要在 console.x.ai 创建账号、购买预付额度并生成密钥。旗舰模型 grok-4.7 拥有 500k token 的上下文窗口，费用为每 100 万输入 token $2、每 100 万输出 token $6。
Grok API 是什么
Grok API 是 SpaceXSI（前身为 xAI）的付费开发者接口。它让你自己的代码能够访问驱动 Grok 应用的同一 Grok 模型家族，以及图片、视频和语音模型。你按 token、每张图片、每秒视频或每分钟音频付费。
API 与面向消费者的套餐是分开的。X Subscription 价格页面在 Plus 下列出了“Grok API access”，但也说明 API 用量单独计费。SpaceXSI 没有解释两者如何配合，所以请做好通过控制台额度支付 API 调用费用的准备。
主要用例都是常见的那些：在你自己的应用中进行聊天和推理、调用工具的智能体、文档和图片理解，以及媒体生成。简明定义请见我们术语表中的 API 条目。
如何获取 Grok API 密钥
SpaceXSI 的快速入门介绍了四个步骤：
- 在 console.x.ai 创建账号。
- 充值预付额度。文档称，必须先有额度，调用才能生效。
- 打开 API Keys 页面并生成密钥。
- 将密钥存储为名为 XAI_API_KEY 的环境变量，而不是写在源代码中。
默认采用预付费计费。额度用完后，请求会被拒绝。你可以开启自动充值，最低金额为 $5。发票计费默认关闭，需要向 SpaceXSI 销售团队申请。
基础 URL、SDK 与端点
所有请求都发送到基础 URL https://api.x.ai/v1。文档列出了三种调用方式：
- xai_sdk，官方 Python SDK。
- OpenAI SDK（Python 和 JavaScript），指向 xAI 基础 URL。
- Vercel AI SDK，通过 @ai-sdk/xai 软件包使用。
Responses API 还是 Chat Completions
位于 /v1/responses 的 Responses API 是 SpaceXSI 的主要接口。位于 /v1/chat/completions 的 Chat Completions 仍受支持。使用 Grok 4.7 时，Responses API 调用总会返回加密的推理内容。旧版 /v1/completions 端点已由 /v1/chat/completions 取代。
Anthropic 风格的端点已弃用
与 Anthropic 兼容的 /v1/messages 和 /v1/complete 端点已被标记为弃用。SpaceXSI 建议用户改用 Responses API 或 gRPC。目前没有给出停用日期，但新项目不应基于它们构建。
美国区域端点
位于 https://us.api.x.ai/v1 的美国端点可确保推理在美国境内进行。其费用为全球费率的 1.1 倍，且只提供 grok-4.7 和 grok-4.6。详情请见我们的 Grok API 价格页面。
一个最简单的首次请求
此示例使用 curl 调用 Responses API。假设你的密钥存储在 XAI_API_KEY 中：
curl https://api.x.ai/v1/responses -H "Authorization: Bearer $XAI_API_KEY" -H "Content-Type: application/json" -d '{"model": "grok-4.7", "input": "Explain a context window in one sentence."}'
有两个设置从第一天起就值得了解：
- reasoning_effort：Grok 4.7 接受 low、medium、high（默认）或 xhigh。
- prompt_cache_key（或 x-grok-conv-id 请求头）：SpaceXSI 强烈建议设置。没有它，请求可能会落到没有缓存的服务器上，从而支付全额输入价格。
字段名称可能会变化。上线之前请查阅官方文档中的请求参考。
Grok API 上的模型
以下是当前的文本模型，价格单位为每 100 万 token 美元。超过 200k token 的提示词费用加倍。
| 模型 | 上下文 | 输入 / 输出 | 备注 |
|---|---|---|---|
| grok-4.7 | 500k | $2.00 / $6.00 | 旗舰模型，2026年9月21日发布。支持文本和图片输入。 |
| grok-4.6 | 500k | $2.00 / $6.00 | 2026年8月12日发布。 |
| grok-4.5 | 500k | $2.00 / $6.00 | 与 Cursor 一起训练。 |
| grok-4.3 | 1M | $1.25 / $2.50 | 窗口最大。有批量折扣。 |
| grok-4.20-0309（推理、非推理、多智能体） | 1M | $1.25 / $2.50 | 多智能体版本让多个智能体处理同一项任务。 |
| grok-build-0.1 | 256k | $1.00 / $2.00 | Grok Build 背后的编程模型。 |
Grok 4.7 Fast 不在公开 API 上，仅在 Cursor 和 Grok Build 中提供。包括 grok-3、grok-4-0709、Grok 4 Fast 和 grok-code-fast-1 在内的多个旧模型已于2026年5月15日停用。对 grok-code-fast-1 的调用现在会转到 grok-build-0.1。
API 还提供 Grok Imagine 图片和视频模型以及 Grok Voice 模型。请见 Grok Imagine 和 Grok Voice API 指南。
内置工具
Grok 模型可以调用 SpaceXSI 为你运行的服务器端工具。价格页面列出了：
- Web Search 和 Image Search。
- X Search，返回 X 上的帖子和个人资料。
- Code Execution。
- File attachment search 和 Collections Search，用于在你自己的文档中进行检索。
- view_image、view_x_video 和 Remote MCP 工具，仅按 token 收费。
大多数工具在 token 费用之外按每 1,000 次调用计费。每个模型还有按等级划分的请求和 token 上限，详见我们的 Grok API 速率限制页面。
常见问题
Grok API 免费吗？
不免费。SpaceXSI 的官方页面没有列出任何免费注册额度，调用需要预付额度。只有第三方网站介绍了一个数据共享额度计划。请见 Grok API 价格。
Grok API 与 OpenAI SDK 兼容吗？
兼容。SpaceXSI 将 Python 和 JavaScript 版 OpenAI SDK 列为受支持的 API 调用方式。只需将其指向基础 URL https://api.x.ai/v1，并使用你的 xAI 密钥。
还能在 Grok 上使用 Anthropic 风格的端点吗？
/v1/messages 和 /v1/complete 端点仍然存在，但已弃用。SpaceXSI 建议改用 Responses API 或 gRPC。
Grok API 上最新的模型是什么？
grok-4.7，于2026年9月21日发布，拥有 500k 上下文窗口，知识截止时间为2026年5月。截至2026年10月18日，Grok 4.8 尚未发布。