Grok API 国内使用指南（2026）：价格、有没有免费额度、API Key 申请与购买、调用地址和中转

下面的价格和规则取自 xAI 官方文档 docs.x.ai（2026 年 10 月 17 日）。xAI 现在以 SpaceXSI 的名义运营，API、控制台和文档的网址都没变。调用写法和报错原文是我们用测试密钥实际跑出来的。

调用地址速查

xAI 现在的文档里没有 Anthropic（Claude）格式的接口，所以 Claude Code 这类只认 Claude 格式的工具不能直接填 xAI 的地址。Cursor、Cherry Studio、OpenAI SDK 这类支持「OpenAI 兼容」的都能直接用。

价格（2026 年 10 月）

文字模型

单位：美元 / 每百万 token。

三条最容易算错的规则：

1. 20 万 token 双倍：一次请求的提示词达到 20 万 token，这次请求的输入、缓存和输出全部按双倍算，不是只有超出的部分翻倍。比如用 Grok 4.7，19.9 万 token 的提示词加 2,000 token 的回答约 0.41 美元；提示词到 20 万，同样的回答就要约 0.82 美元。处理长文档时，尽量切到 20 万以下。
2. 推理 token 要付钱：推理模型「思考」产生的 token 单独列出、要计费，预算时按输出算。
3. Grok 4.7 Fast 不在 API 里：它是同一个模型的加速版，只在 Cursor 和 Grok Build 里提供，公开 API 调不到。

Imagine：生图和视频

一段 10 秒的视频，1.5 Lite 是 0.2 美元，1.5 是 0.8 美元。

其他费用

• 服务端工具按次另算：联网搜索（web_search）和代码执行每千次 5 美元；搜 X（x_search）按返回结果算，每千条帖子 5 美元、每千个用户资料 10 美元。
• Batch 批量接口只对 grok-4.3 和 grok-4.20 系列打 8 折，其他模型没有折扣。
• Priority 优先处理是标准价的 2 倍。

有没有免费额度

没有公开的免费档。官方快速入门第一步就是注册后「充值 credits 再开始用 API」，价格页上也没有免费档。网上「Grok API 免费」的说法，常见的有这几种：

Grok 会员和 API 是两回事

xAI 现在的会员叫 The X Subscription（原来的 SuperGrok、X Premium、Cursor 会员可以继续用，不强制换）：

会员的用量用于 Grok 应用、Grok Bot 和 Cursor 里的 Grok 模型，按每周额度算，用完可以另买额外用量。xAI 文档里没有说会员包含开发者 API 额度。所以：

• 只想聊天、用 Grok 应用：买会员。
• 要写程序调用、接到自己的工具里：用 API，按 token 付费，在 console.x.ai 另外充值。

怎么申请 API Key

1. 打开 console.x.ai，注册账号。
2. 进入 Billing，给团队充值（见下一节）。
3. 打开 API Keys 页面，创建密钥，复制保存。
4. 把密钥放进环境变量：export XAI_API_KEY="你的密钥"。

密钥属于「团队」（team），同一个团队的人共用余额和限速。官方提醒：不要在队友之间共用同一把密钥，不要把密钥写进代码仓库。

怎么购买 / 充值

官方 API 是预付制，规则如下：

• 付款方式：在 Billing → API spend management 购买 credits，信用卡即时到账；银行转账要 2 到 3 个工作日，到账后才给额度。文档注明目前只能通过「Guest Checkout」购买预付额度。
• 自动充值：可以开 Auto top-up，余额低于你设的数字就自动买，每次至少 5 美元，可以设每月上限。
• 余额用完会怎样：默认不开月结（invoiced billing limit 为 0），余额一用完，请求会被自动拒绝。要月结得联系销售开通。
• 能不能退：官方明确说预付的 API credits 不退款（法律另有规定的地区除外）。先少充一点试。
• 发票：账单地址和税号会印在发票上，发票不能重开，第一次填就要填对。

限速档位：按累计消费自动升级

限速分 5 档，按 2026 年 1 月 1 日以来在 API 上的累计消费自动升级，升上去就不会再降：

超过限速返回 429 Too Many Requests。自己当前的档位和每个模型的限额，在控制台的 Models 页面看。Imagine 生图视频的限额不跟档位走，要提额得找销售。

国内能不能用

先说清楚我们查到的事实：

• xAI 没有像 OpenAI、Anthropic、谷歌那样公布「支持地区」列表。企业服务条款里要求遵守适用的出口管制和制裁法规，不得向受美国全面制裁的国家和地区、以及制裁名单上的人提供服务。
• 付款方式有限：官方只列了信用卡和银行转账，按美元计价，账单地址、税号会写进发票。国内发行的卡能不能付成功，官方没有说明。
• 条款要求凭据保密：企业条款要求每个被授权使用的人对登录凭据严格保密、不得分享给未授权的人，也不能让第三方在授权范围以外使用服务。所以找人合买、买别人的 Key 都不合规，出了问题钱也很难追回。
• 我们没有在国内网络下测试能不能直连 api.x.ai，这一点以你自己的实际情况为准。

所以国内开发者常见的做法是：通过提供 Grok 模型的第三方 API 服务调用（也常被叫作「中转」）。Grok 的接口本来就是 OpenAI 格式，第三方服务基本都兼容，代码里只改 base_url 和密钥。数据会经过服务商，涉及敏感数据或对外提供服务的，先看服务商的隐私条款，并遵守所在地的相关规定。

选第三方服务时，Grok 要多看这几项

通用的挑选方法见 API 中转站是什么？怎么选不踩坑。Grok 有几处特别的地方：

1. 模型名和版本对不对。Grok 版本更新快，4.3、4.5、4.6、4.7 价格不同，确认服务商给的是你要的那个版本。
2. 20 万 token 以上怎么算。官方是整个请求双倍，看服务商写没写清楚自己的规则。
3. 推理 token 算不算钱、怎么算。用推理模型时，回答之外的「思考」可能比回答本身还长。
4. 生图按张还是按 token、每张对应哪个模型（image、image-2.0、quality 价格差一倍多）。
5. 支不支持 Responses 接口。xAI 官方支持 /v1/responses，Codex 只用这个接口，只支持 Chat Completions 的服务接不了 Codex。
6. 能不能查到每次调用的明细：用了多少 token、扣了多少钱。

调用示例

官方：curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-4.7", "messages": [{"role": "user", "content": "用一句话介绍你自己"}]}'

官方：Python（OpenAI SDK）

先安装：pip install openai。

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")
resp = client.chat.completions.create(
    model="grok-4.7",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

生图：

img = client.images.generate(model="grok-imagine-image-2.0", prompt="一只在键盘上睡觉的橘猫")
print(img.data[0].url)

xAI 也有自己的 Python SDK（pip install xai-sdk），用法见官方文档；已经用 OpenAI SDK 写好的程序，改上面两处就够了。

通过第三方服务调用（以 api.foo 为例）

只改 base_url 和密钥，地址要带 /v1：

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["APIFOO_API_KEY"], base_url="https://api.foo/v1")
resp = client.chat.completions.create(
    model="grok-4.7",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

我们用测试密钥调了对话（/v1/chat/completions）、Responses（/v1/responses）和生图（/v1/images/generations）三个接口，请求都到达了 api.foo，地址和格式都对。api.foo 用人民币计价，支持支付宝、微信、银行卡和 USDT（BSC 链），最低充值 5 元（USDT 40 元起）；可用的 Grok 模型名和价格见模型广场。长推理或生图如果超过 100 秒被断开，可以把地址换成直连线路 https://dc.api.foo/v1。

常见报错

报错原文可以直接复制到页面里搜索（Mac 按 Cmd+F，Windows 按 Ctrl+F）。

400 Incorrect API key provided：密钥不对

{"code":"invalid-argument","error":"Incorrect API key provided. You can obtain an API key from https://console.x.ai."}

注意是 400，不是 401（官方报错页写的是 401，实际返回 400）。用 OpenAI 的 Python SDK 时，抛出的是 BadRequestError，不是 AuthenticationError。如果你的代码只捕获认证错误，密钥写错时会走到别的分支，排查时容易绕弯。检查密钥有没有复制完整、有没有被删除。

401 No credentials presented：没带密钥

{"code":"unauthenticated:no-credentials","error":"No credentials presented."}

请求头里没有 Authorization。常见原因是环境变量 XAI_API_KEY 没设好，或者程序读的是别的变量名。

429 Too Many Requests：超过限速

请求太频繁或 token 太多，超过了当前档位的限额。按官方建议用指数退避重试（等 1 秒、2 秒、4 秒……）；长期不够用，累计消费到下一档会自动升级，也可以在控制台申请提额。

余额用完：请求被拒绝

默认不开月结，余额一到 0，请求就会被拒。去 Billing 充值，或者打开自动充值。

403 / 404

403 是没有权限（比如团队管理员没给你这个功能），找团队管理员；404 一般是地址或模型名写错了，对照官方模型列表检查。

用第三方服务时的报错

报错的格式由服务商决定。比如 api.foo 这类基于 New API 搭建的服务，密钥不对时返回 401 无效的令牌，余额不够时返回 用户额度不足。更多见 API 报错排查大全。

相关阅读

• API 中转站是什么？怎么选不踩坑
• OpenAI API 国内使用指南
• Gemini API 国内使用指南
• 国产大模型 API 价格对比
• API 报错排查大全
• 英文版：Grok API pricing, API key and code examples

参考资料

xAI 官方，2026 年 10 月 17 日查阅：价格、模型、快速入门、限速、结算、结算常见问题、报错、区域端点、The X Subscription 价格、企业服务条款、企业版常见问题。