如何创建 Grok API 密钥，以及替代密钥

通过供应商创建密钥

我们是独立服务，并非官方 xAI API，因此对于 xAI 自己的密钥，你需要访问 xAI 自己的页面。流程与大多数提供商通用，但菜单名称可能与下文不同。

1. 使用你的账户登录提供商的开发者控制台。
2. 检查计费部分。某些提供商在密钥生效前需要支付方式或存款；阅读您的提供商的要求。
3. 打开 API 密钥部分并选择创建新密钥。
4. 给它起一个表明其用途的名称，例如项目或环境。
5. 立即复制密钥。许多控制台仅显示一次完整密钥。
6. 将其存储在密钥管理器或环境变量中，不要存储在源代码中。

如果页面布局不匹配，提供商的文档是权威来源。几个月前编写的任何指南，包括本文，可能描述的是较旧的界面。

在一分钟内获取密钥

我们的密钥用于一个托管的开放权重模型的 OpenAI 兼容接口，该模型经过调整，可在合法成人使用中无内容拒绝地回答。获取密钥需要五个步骤。

1. 打开 API 密钥页面。
2. 使用 Google 账号或电子邮件和密码注册。
3. 点击一次领取您的 $0.50 试用额度。每人限领一次，有效期 7 天，无需卡片。
4. 复制页面上显示的密钥。
5. 运行下面的测试调用。

基础 URL 为 https://api.grokaiapikey.com/v1，模型 ID 为 uncensored，密钥需放入 Authorization: Bearer 请求头中。

测试密钥

从 curl 开始。如果此命令返回 JSON 答案，说明您的密钥、基础 URL 和模型都正确。

Copyexport API_KEY="paste-your-key-here"

curl https://api.grokaiapikey.com/v1/chat/completions   -H "Authorization: Bearer $API_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored",
       "messages": [{"role": "user", "content": "Reply with the word ready."}]}'

在 Node 中，官方 OpenAI 包在更改两个设置后即可工作。

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.grokaiapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Reply with the word ready." }],
});
console.log(r.choices[0].message.content);

Python 用户可以使用 OpenAI(base_url=..., api_key=...) 实现相同功能。可用的方法是 POST /v1/chat/completions、POST /v1/responses 和 GET /v1/models。

将密钥设置为环境变量

不要将密钥粘贴到源代码中。将其放入环境变量，并在运行时读取。命令因系统而异。

Copy# macOS or Linux, current shell session
export API_KEY="paste-your-key-here"

# Windows PowerShell, current session
$env:API_KEY = "paste-your-key-here"

# Check that the variable is set (macOS or Linux)
test -n "$API_KEY" && echo "key is set"

对于项目，将值存储在 .env 文件中，该文件列在 .gitignore 中，并使用你框架的加载器加载它。在服务器上，使用主机的密钥存储或部署平台的环境设置。本网站的基础 URL 是 https://api.grokaiapikey.com/v1，由于它不是机密，因此可以安全地保留在代码中。

如果你运行多个服务，请为每个服务提供自己的密钥。已充值的账户最多可以持有 5 个密钥，因此预发副本、生产副本和个人测试密钥可以共存，每个都有各自的标签。

如果调用失败

症状	可能原因	修复方法
401 未授权	缺少或拼写错误的密钥	检查 Bearer 头部并查找尾随空格或引号
404 未找到	错误的基础 URL	路径必须是 api 子域上的 /v1/chat/completions
模型错误	模型名称错误	使用模型 ID uncensored
429 rate_limited	每分钟请求过多	试用密钥允许每分钟 60 次；减慢速度
429 并发	同时进行的请求过多	试用密钥允许 2 个进行中请求；流式输出会占用其槽位直到结束

带有 Retry-After: 5 头的 429 表示临时过载。等待五秒并重试。

使用请求 ID

每个响应都包含一个 X-Request-Id 头。将其记录在你自己的错误消息旁边。如果你向 支持团队询问失败的调用，请求 ID 让他们精确找到该次调用，而不是猜测。在 curl 中，添加 -i 以打印响应头，在 Python SDK 中，你可以使用原始响应辅助函数读取它们。

当问题间歇性出现时，响应头也能提供帮助：X-RateLimit-Limit-Requests 和 X-RateLimit-Limit-Concurrency 显示了适用于你密钥的限制，让你一目了然地判断当前使用的是试用密钥还是完整密钥。

替换或添加密钥

你无需请求他人来轮换密钥。在 API 密钥页面，你可以随时重新生成（重新签发）密钥，旧密钥会立即失效。一旦发现密钥出现在公共代码仓库、截图或共享聊天中，请立刻执行此操作。

已充值的账户最多可以持有 5 个密钥。为每个密钥标记标签，例如 staging 或 mobile app，并撤销任何单个密钥而不影响其他密钥。每个环境一个密钥是一个好习惯，因为撤销泄漏的预发密钥不会对你的生产流量产生任何成本。

在现有工具中使用密钥

你无需编写代码即可使用密钥。许多聊天前端和开发者工具都支持自定义 OpenAI 兼容接口，SillyTavern 就是一个公开示例。配置过程始终需要填写相同的三个值。

• 基础 URL 或 API URL： https://api.grokaiapikey.com/v1
• API 密钥： 你复制的密钥
• 模型名称： uncensored

某些工具需要以 /chat/completions 结尾的完整路径；其他工具则自行添加。如果收到 404，请尝试另一种形式。如果工具的模型下拉菜单保持为空，请手动输入模型名称，或让它从 GET /v1/models 获取列表，该列表返回单个模型 ID。

流式输出通过相同的设置工作。如果回复一次性出现而不是逐字出现，请在工具中查找流式输出切换开关。

保护密钥安全

• 将其保留在服务器端。放置在浏览器 JavaScript 或移动应用包中的密钥可被任何人读取。
• 从环境变量加载密钥，并在首次提交前将你的 env 文件添加到 .gitignore 中。
• 养成监控消费的习惯：留意 X-Balance-USD 响应头，以便在余额意外下降时立即察觉。
• 为不同的服务使用不同的密钥，以便在无需影响其他服务的情况下撤销单个密钥。

测试调用成功后，请阅读文档了解流式输出、函数调用和 JSON 模式，并查看定价页面获取费率：输入 token 每 100 万 $0.15，输出 token 每 100 万 $0.50。如果你正在将其与封闭供应商进行比较，我们的文章为什么开发者转向无审查模型涵盖了相关权衡。

简单的轮换流程

1. 在 API 密钥页面，创建或重新生成你要替换的密钥。重新生成会使旧密钥立即失效，因此请在代码准备好接收新值时再执行此操作。
2. 更新所有使用该密钥的环境变量或密钥库。
3. 重启服务并运行本文中的 curl 测试。
4. 在笔记中记录日期。对于大多数项目，每隔几个月设置一次日历提醒即可。

如果充值后你持有多个带标签的密钥，请逐个轮换。首先撤销与笔记本电脑或前团队成员关联的密钥，因为这些密钥最有可能泄露。

更多指南

• 免费 Grok API 密钥：什么是真的，什么是骗局
• Claude API 密钥：开发者为何转向无审查模型