如何获取 Grok API Key 并完成第一次调用（Grok 4.6）

Grok API Key 是 xAI 从其开发者控制台签发的凭据，让你的代码可以通过 HTTPS 调用 Grok 模型。你只需创建一次，之后在每个请求中作为 Bearer token 发送，xAI 会按你消耗的 token 从团队的预付额度中扣费。如果这个概念对你来说很陌生，什么是 API Key 一文介绍了基础内容；本文面向的是希望今天就把 Key 跑起来的开发者。

流程如下：先在 console.x.ai 上创建 Key，用 curl 发一次请求、再用 Python 发一次，然后把 Key 迁入 Apifox，以便安全存储、无需把它粘贴到 shell 里就能发请求，并把第一次请求变成一个可保存的测试。当前旗舰模型是 grok-4.6，下面所有示例都用它。

AI Coding 交流群

如果你也在用 AI 写代码，或者正在研究 Cursor、Claude Code 这些工具，欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流，还有各种新工具和新玩法。

开始前的准备

一个 xAI 账号。在 console.x.ai 注册。

账号里有额度。控制台采用预付额度机制，官方 quickstart 建议你在注册后立刻充值。余额为零时，请求会被拒绝。
curl（macOS 和大多数 Linux 发行版自带）以及 Python 3.9 或更高版本，并装有 pip。
Apifox，如果你希望把请求保存下来、做测试并分享给他人。免费版支持 4 名用户，对小型团队已经够用。

第 1 步：在 xAI 控制台创建 Key

登录并打开 Billing。在 API spend management 下用信用卡购买额度（立即到账）或通过银行转账（两到三个工作日，见计费文档）。
打开 API Keys 页面。quickstart 中给出的链接是 console.x.ai/team/default/api-keys。team 这一段很重要：Key 属于某个 team，而不属于你的个人登录账号。
点击 Create API key，起一个你半年后还能认出来的名字。“apifox-local-dev” 比 “key1” 好得多。
Key 创建后立刻复制。要把它当成你唯一一次能看到完整值的机会。
把它存成环境变量，而不是写进代码里：

export XAI_API_KEY="paste-your-key-here"

XAI_API_KEY 是官方文档使用的变量名，因此 xAI 自家的 SDK 和大多数社区集成都能直接识别，无需额外配置。

每个环境使用一个独立的 Key 是个好习惯。为本地开发、CI 和生产环境分别使用不同的 Key，意味着某台笔记本上的 Key 泄露时可以单独删除，不影响其他任何东西。

第 2 步：用 curl 发出第一个请求

xAI 的主要文本接口是 POST https://api.x.ai/v1/responses。在 Authorization header 中发送 Key，body 用 JSON，模型 id 放在 model 字段中：

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.6",
    "instructions": "You are a senior backend engineer. Answer in three sentences.",
    "input": "My API returns 429 to a client that retries instantly. What should the client change?"
  }'

成功的响应是一个包含 output 数组的 JSON。文本位于 output[].content[].text，其 "type": "output_text"，并且有一个 usage 对象报告 input_tokens、output_tokens 和 total_tokens，以及推理和缓存 token 的分项。这些 usage 数字就是计费依据，所以从第一天起就要把它们记录下来。

两个值得了解的细节：

instructions 就是系统提示词。如果你更习惯 chat 的结构，也可以把 input 传成 {role, content} 消息数组。
如果你已有 OpenAI 风格的代码，POST https://api.x.ai/v1/chat/completions 用同一个 Key 和模型 id 仍然可用。xAI 把它标记为遗留接口，新功能会优先在 Responses 上发布，所以新项目请从 /v1/responses 开始。

关于同一个接口上的流式、工具调用和图片输入，见如何使用 Grok 4.6 API。

第 3 步：用 Python 发起同样的调用

xAI 的 REST API 兼容 OpenAI SDK，因此你不需要新的客户端库。把 base_url 指向 xAI，并从环境变量中读取 Key：

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.6",
    instructions="You are a senior backend engineer. Answer in three sentences.",
    input="My API returns 429 to a client that retries instantly. What should the client change?",
)

print(response.output_text)
print(response.usage.input_tokens, response.usage.output_tokens)

用 pip install openai 安装 SDK。读取 os.environ["XAI_API_KEY"] 时，如果变量缺失会抛出清晰的 KeyError，这比发送一个空的 Bearer header 再去调试 401 要好得多。

xAI 也提供原生 Python SDK（xai-sdk），支持 gRPC 传输以及 Collections、Voice API 等额外功能。但如果只是发第一个请求，用 OpenAI 客户端路径更短。

第 4 步：在 Apifox 中存储并测试 Key

把 Key 粘贴到终端里只能管一次。要和同事共享请求、在模型更新后重跑、或者放进 CI 时，API 客户端才有价值。以下是在 Apifox 中的流程。

把 Key 存为本地值。打开环境，新建一个名为 “xAI” 的环境，添加两个变量：baseUrl，共享值填 https://api.x.ai/v1；XAI_API_KEY，共享值填占位符，本地值填你的真实 Key。共享值会同步给团队成员；本地值只留在你自己机器上的客户端缓存里，永远不会上传到 Apifox 的服务器。变量名随项目分发，密钥不会。Apifox 环境与密钥变量一文深入介绍了共享值与本地值的区别，包括 CI 如何注入自己的 Key。

发送第一个请求。新建一个接口：POST {{baseUrl}}/responses。在 Auth 标签页选择 Bearer Token，填入 {{XAI_API_KEY}}。粘贴第 2 步的 JSON body，选择 xAI 环境，点击发送。响应面板会显示状态、耗时和解析后的 body，你可以直接点进 output 和 usage，而不必读原始 JSON。

把它保存成测试。在 Post Processors 中添加一个 Assert 步骤：状态码等于 200，并用 JSONPath 校验 $.model 等于 grok-4.6。再加一条断言：$.usage.output_tokens 大于 0。保存接口，打开测试，新建一个测试场景，把该接口导入其中。此后一键就能重跑这个调用，并告诉你 Key、模型 id 和响应结构是否仍然可用。

可选：mock 掉它。把真实响应保存为该接口的示例，然后切换到 Apifox 的 mock URL。前端开发和单元测试可以针对一个假的 Grok 响应运行，不消耗额度也不触发速率限制。

限额、额度与定价

计费。额度按团队预付。自动充值可以在余额低于你设定的阈值时自动购买（每次充值最低 $5），可设置每月上限，并在达到上限 80% 时给出警告。月度开票是存在的，但默认关闭且需要走 xAI 销售；在默认的 $0 开票额度下，预付额度一用完，请求就会被拒绝。

Grok 4.6 定价，每百万 token，来自官方定价页：

提示词长度	输入	缓存输入	输出
少于 200k token	$2.00	$0.50	$6.00
200k token 及以上	$4.00	$1.00	$12.00

上下文窗口是 500k token。请求的提示词一旦跨过 200k 阈值，其全部 token 都按更高费率计费，而不只是超出的那部分。

速率限制。xAI 限制每秒请求数和每分钟 token 数。具体数值取决于你的层级：从 0 到 4 共五个层级，外加 Enterprise，自 2026 年 1 月 1 日起按累计消费自动解锁，且层级永不降级。你团队的当前限额显示在控制台的 Models 页面上。每个 token 都计入 TPM，包括推理 token 和缓存的提示词 token。

免费额度。xAI 的文档描述的是预付模式，并没有宣传 API 有长期免费的层级。控制台偶尔会出现促销额度；请查看你自己的 Billing 页面，而不是依赖某篇博客文章。

常见错误及排查方法

401 Unauthorized。Key 缺失、格式错误或已被删除。检查 header 是否为 Authorization: Bearer <key> 且只有一个空格，确认运行 curl 的 shell 中已设置 $XAI_API_KEY（echo $XAI_API_KEY | wc -c 应输出大于 1），以及该 Key 在控制台上仍然存在。复制粘贴带来的尾部换行是经典原因。

403 Forbidden。Key 有效，但不允许执行你请求的操作。可能的原因：Key 或 team 被封禁、额度已耗尽且开票额度为 $0，或者该 team 无权访问该模型。先检查 Billing，再到 API Keys 页面检查这个 Key。

429 Too Many Requests。你已经触及所在层级的 RPS 或 TPM 上限。加上带抖动的指数退避、限制并发数、精简提示词长度，并把批量任务迁移到 Batch API。如果你整天都贴着上限，解决办法是提升消费层级，而不是改代码。

400 Bad Request。通常是模型 id 写错（是 grok-4.6，不是 grok-4-6）或 JSON 无效。错误 body 会指出是哪个字段。

关于如何解读这些响应（包括流式和工具调用失败）的更完整讲解，见如何测试和调试 Grok 4.6 API 请求。

常见问题

Grok API Key 有免费的吗？

没有作为长期政策明确提供的免费额度。该 API 采用预付额度，quickstart 建议你在第一次调用前先充值。如果你的目标是试用 Grok 而不是基于它做开发，如何免费使用 Grok 一文介绍了无需 Key 的面向消费者的途径。

Grok API Key 能配合 OpenAI SDK 使用吗？

可以。设置 base_url="https://api.x.ai/v1"，并把你的 xAI Key 作为 api_key 传入。client.responses.create() 和遗留的 client.chat.completions.create() 都可以配合 model="grok-4.6" 使用。

请求里应该填哪个模型 id？

旗舰模型用 grok-4.6。别名 grok-4.6-latest 会跟随最新修订版本。像 grok-4.5 和 grok-4.3 这样的旧 id 仍在列表中并有各自的定价，但新项目应该从 4.6 开始。

Key 泄露了该怎么办？

立刻在 API Keys 页面上删除它，创建一个替代 Key，并在所有使用它的地方更新环境变量。然后在你的仓库和 CI 日志中搜索旧值。在 Apifox 的企业版中，Secret Scanner 会标记出散落在请求、变量、脚本和文档中的 Key，这正好能覆盖有人把 Key 粘贴到共享值而不是本地值的情况。