如何获取并配置 xAI Grok API Key 密钥

Grok 是由马斯克创立的 xAI 开发的前沿大语言模型 (LLM) 家族。在 Griptape Nodes 中，你可以通过 GrokPrompt 配置算子节点直接调用其模型能力。为了使用这些模型，你需要注册一个 xAI 开发者账户并生成专有 API 密钥。值得注意的是，xAI 是一项完全按量付费的云端商业服务，若要正常发起 API 调用，必须预先在其官方平台上绑定支付与结算信息。

---

账户注册、支付绑定与密钥签发 (Account and API Key Creation)

在生成密钥之前，你首先需要拥有一个 xAI 账号。前往官网 https://x.ai：

已有账号提示

若你已经注册过 xAI 开发者账号，可直接跳过注册，前往 第 2 步：绑定账单与支付。

1. 注册 xAI 开发者账户

1. 点击官网上的控制台登录入口，或直接在浏览器打开 https://accounts.x.ai/sign-up；

   

2. 按照向导提示完成注册流程（步骤极其简明顺畅）。

   

2. 绑定账单与支付信息 (Set Up Billing)

强制要求绑定支付账户

在 Griptape Nodes 中调用 xAI 系列模型前，必须且强制要求在 xAI 官方平台完成账单信息的绑定与信用充值。若未完成此步骤，模型调用通道在物理上将处于未激活状态。

若未绑定账单便强行在画布中执行 Grok 节点，你的工作流将直接报错失败，服务端会以“账户未绑定有效凭据/无可用额度”为由拒绝请求。

3. 生成 API Key 访问凭证

1. 在控制台导航栏中定位至 API Keys 管理区域（页面有多处快速直达链接）；

   

2. 点击 Create API Key 按钮；

   

3. 为该密钥输入一个易于辨识的别名（例如：GriptapeNodes）；

   

4. 点击 Save 保存；

5. 复制并安全妥善保存屏幕上生成的 API 密钥明文。

   安全合规警示

   强烈建议将该 Token 存放在专业的密码管理器（如 1Password、Bitwarden）或加密笔记中。该访问密钥代表你个人在 xAI 的商业调用凭据与扣费权限，切勿将密钥明文硬编码提交至公共 GitHub 仓库、截图录屏或通过即时通讯软件发送给他人。请像保管银行卡密码一样严肃对待它。

---

将 Grok API Key 登记至 Griptape Nodes 全局配置中

概览

准备好 xAI 账户与有效密钥后，只需在 Griptape Nodes 的图形设置面板中完成登记即可。

1. 打开 Griptape Nodes 设置菜单

1. 启动并进入 Griptape Nodes 图形编辑器；
2. 在顶部主菜单栏（位于 File 与 Edit 右侧）中找到并点击 Settings；
3. 选择对应项打开全局配置编辑器。

2. 在 API Keys & Secrets 中登记 xAI 密钥

1. 在左侧配置树状分类中，点击 API Keys and Secrets；
2. 向下滚动定位至 GROK_API_KEY 输入框字段；
3. 将刚才从 xAI 控制台复制的密钥字符串粘贴至该输入框中；
4. 直接关闭配置编辑器窗口——系统会自动持久化保存新设置并热重载生效。

配置生效完毕

完成上述配置后，画布上所有使用 Grok 架构的智能体与提示词配置节点，均会自动直连 xAI 官方端点进行算力调用与推理。