Grok API 入门：密钥、客户端配置与第一次调用

当你想把 Grok 接进脚本、自动化或其他客户端时，需要使用 xAI API。这篇带你完成账号准备、密钥配置和第一次 Python 调用。

资料核对日期：2026 年 9 月 8 日。示例使用官方快速开始当前列出的 Responses API。只想聊天，可以先看 Grok 网页与手机教程。

先准备 API 账户

打开 xAI 控制台，登录后确认当前团队和账单信息。按控制台要求开通 API 使用额度，然后在 API Keys 页面创建密钥。

Grok 网页或手机订阅与 API 使用额度要分别确认。能在网页里正常聊天，不代表这个 API 团队已经有余额。

API 密钥用于代表你的账户发起请求，应保存在本机环境变量或客户端专门的密钥栏中，不要写进公开代码、截图或博客文章。

配置其他客户端时，核对这三项

如果客户端提供 xAI 官方预设，优先选择它。手动选择 OpenAI-compatible 时，也要把服务地址改为 xAI 的地址，并确认客户端支持所选模型的接口。

本文使用 Responses API，完整请求地址是 https://api.x.ai/v1/responses。客户端要求填写 Base URL 时通常只填到 /v1，不要再把完整接口路径重复加进去。

当前官方示例使用 grok-4.6。如果账户没有这个模型的权限，从 官方模型列表 和控制台选择可用的模型 ID，并替换下文配置。

在电脑上准备 Python

先安装 Python。创建一个新的 grok-api-demo 文件夹，在终端进入这个文件夹，然后为它建立独立环境。

macOS / Linux

python3 -m venv .venv
.venv/bin/python -m pip install --upgrade openai

Windows PowerShell

py -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade openai

这里使用 xAI 官方文档支持的 OpenAI 兼容 Python SDK。安装这个库不要求你另有 OpenAI API 账号，请求会发送到下面配置的 xAI 地址。

我们直接调用虚拟环境中的 Python，不需要先修改 PowerShell 执行策略来激活环境。

设置当前终端的环境变量

把下面的密钥占位文字换成自己创建的密钥。模型 ID 按账号可用范围填写。

macOS / Linux

export XAI_API_KEY="在这里填入你的 xAI API 密钥"
export XAI_MODEL="grok-4.6"

Windows PowerShell

$env:XAI_API_KEY = "在这里填入你的 xAI API 密钥"
$env:XAI_MODEL = "grok-4.6"

这些设置只对当前终端及其启动的程序生效。换一个终端运行时需要重新设置。单独创建 .env 文件不会让下面的程序自动读取它。

发出第一次请求

在这个文件夹创建 grok_demo.py：

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=os.environ["XAI_MODEL"],
    input="请用简体中文，用三句话向非程序员解释 API 是什么。",
)

print(response.output_text)

macOS / Linux 运行：

.venv/bin/python grok_demo.py

Windows PowerShell 运行：

.\.venv\Scripts\python.exe grok_demo.py

这会发出一次真实 API 请求并产生对应的 API 用量。终端输出中文回答，且控制台能看到对应使用记录，就说明密钥、服务地址、模型与程序环境已经连通。

几种常见错误

报错时保留状态码和错误正文，分享排错信息前去掉密钥。不要只看到“调用失败”就反复更换模型或安装整个环境。

下一步做一个小应用

第一次调用成功后，可以把固定问题换成用户输入，做一个小型文章提纲助手，再增加明确的长度和输出格式要求。

如果目标是让 Grok 直接管理本地项目，可以使用已经封装好文件和命令工具的 Grok Build。普通 API 调用只会返回模型结果，本身不会自动读取你的项目或执行电脑命令。

官方参考

• xAI API 快速开始
• 模型列表
• API 价格与计费
• Grok Build 概览