Grok API 使用教程：从注册到第一次调用

Grok API 是给程序调用的接口，文档里的主机是 api.x.ai。Grok API 和在 grok.com 里聊天不是同一件事。钥匙到 console.x.ai 申请，第一次请求的基址是 https://api.x.ai/v1。网页会员各档见 各档会员价格。

Grok API 是什么，和 grok.com 会员是两回事

结论Grok API 走开发者控制台；grok.com 上的会员是另一份账单。

推理说明写明，这套 REST 兼容 OpenAI。快速开始把基址写成 https://api.x.ai/v1，同一页给出 OpenAI SDK 和 xai-sdk。你可以沿用熟悉的 SDK 来接 Grok API，只改地址，也可以装官方 SDK。两套都是在调用 Grok API，不是两个产品。

账号可以共用。控制台 FAQ 写：已有 Grok 账号的人，可以用这个账号访问 API，登录在 accounts.x.ai。下一句写明账单分开。调用费用在 xAI Console；会员账单在 grok.com 的设置里，在苹果或 Google 购买的，到对应商店查看。聊天天会员，不会自动变成 Grok API 的钥匙。

费用数字不抄在这里，只给出处：API 费用说明。终端里改代码是另一条线，见 Grok Build 是什么。

申请 API Key（console.x.ai）

结论Grok API Key 获取在 console.x.ai 的 API Keys 页面，聊天网页上没有这一项。

快速开始的顺序是：

  1. 打开 console.x.ai 注册。文档写，注册后要先准备 credits，才能开始调用 Grok API。准备多少，以费用说明那一页为准。
  2. 到 API Keys 页面新建一把钥匙。这一步才算拿到 Grok API 的凭证。
  3. 放进环境变量，名字用 XAI_API_KEY。可以在 shell 里 export，也可以写进 .env。真钥匙不要出现在文章、截图或仓库里。

同一邮箱用不同方式注册时，控制台可能问你新建账号，还是连到已有账号。内容和订阅不会合并。登错空账号，会以为钥匙丢了。登录方式到 accounts.x.ai 查看。

钥匙属于某个团队。停用前先看控制台里是不是这一个团队。个人注册时会有 Personal Team。

第一次调用

结论Grok API 怎么用，第一次只要基址、环境变量里的钥匙，和模型名。

官方示例里，Grok API 的基址是 https://api.x.ai/v1，文字请求走 /v1/responses，模型名写 grok-4.7。从 chat completions 迁过来时，对照页让你把路径换成 /v1/responses，并把 messages 改成 input。

下面用 OpenAI SDK 发一句最短请求。钥匙从环境变量读取：

```python import os from openai import OpenAI

client = OpenAI( api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1", ) response = client.responses.create(model="grok-4.7", input="Hello") print(response.output_text) ```

官方 SDK 的安装命令是 pip install xai-sdk，OpenAI 那套是 pip install openai。运行前确认环境里已有 XAI_API_KEY。这段只返回文字。图片、视频和语音各有自己的路径，不要拿文字接口去生图。

安全说明另写了一条默认规则：请求和响应加密存放 30 天，用于异常排查，到期删除；未经明确允许，不会拿去训练。这不是调用 Grok API 时要在代码里多写的参数。

选哪个模型

结论文字和代码用文档点名的 Grok 4.7。图片、视频、语音不要填进 Grok API 的同一个 model。

模型页写，代码和聊天都用 Grok 4.7，原话是 the most capable model we've built。图片是 Grok Imagine Image 2.0，视频是 Grok Imagine Video 1.5，语音是 Grok Voice API。名字不带后缀时指向当前稳定版，-latest 指向最新版。

在 Grok API 里换模型，改的是请求中的 model。网页和 App 上能点到哪一版，和这份清单不是同一张表，见 Grok 模型有哪些。grok.com 上的 Auto、Fast 不要当成这里的参数名。

SuperGrok 会员能不能用 API

结论账号可以共用。SuperGrok 的会员账单不能代替控制台里的调用额度。

账号 FAQ 已经写了同一账号可以访问 API，账单仍然分开。快速开始把「准备 credits」放在创建钥匙之前。会员费是否附带调用额度，这两页没有写成同一句话。

所以，SuperGrok 能用 API 吗，要拆开看。能登录，是因为账号共用。能不能发出 Grok API 请求，还要看团队里有没有调用额度。老套餐怎么对应，见 SuperGrok 订阅现在怎么开。免费版里有没有钥匙，见 Grok 免费吗。

安全提醒

结论钥匙当成密码。只放在自己的程序里，并且只发往文档写明的主机。

安全 FAQ 可以收成四条：

  • 不要把同一把钥匙分给同事。
  • 用环境变量或密钥工具保存。不要提交到公开仓库，也不要写进源码。
  • 怀疑泄露时，登录控制台，确认团队，在 API Keys 里停用或删除，再新建一把，并改掉环境变量。
  • 官方与 GitHub 的密钥扫描合作。已经公开的钥匙会被停用，并邮件通知。

调用 Grok API 时，文档使用的主机是 api.x.ai。不要把 XAI_API_KEY 粘到来路不明的第三方接口，也不要贴进来历不清的表单。对方拿到这串字符，就等于拿到调用权限。

常见问题

Grok 有 API 吗？

有。推理、图片、视频和语音都有文档。程序要走的就是 Grok API，入口在 console.x.ai，不在聊天框。

Grok API Key 怎么获取？

在 console.x.ai 打开 API Keys 创建，再写入 XAI_API_KEY。这一页就是 Grok API Key 获取的位置。创建前，快速开始要求先准备 credits。

Grok API 怎么用，第一次调用看哪？

第一次调用 Grok API，看基址 https://api.x.ai/v1、环境变量里的钥匙，以及模型名。文字示例用 /v1/responses 和 grok-4.7。

SuperGrok 能用 API 吗？

同一 xAI 账号可以登录控制台。能不能调用 Grok API，还要看 Console 里有没有额度。

费用数字为什么不写在这里？

调用怎么扣，只看 API 费用说明。本页不抄表。

相关页面

用 Grok API 之前，这几页可以一起看。

官方来源

最后核对：2026-10-22｜价格和规则以 x.ai 官方页面为准