Grok API 由 xAI(官方资料中已出现 SpaceXAI 名称)提供,接入只需三步:在 console.x.ai 注册并创建 API Key,用现成的 OpenAI SDK 把 base_url 换成 https://api.x.ai/v1,再把 model 换成当前旗舰 grok-4.6。接口完全兼容 OpenAI 协议,支持流式、工具调用、视觉输入与服务端搜索。国内团队还需注意"200k token 价格悬崖"与老模型 slug 重定向两个坑。 grok api 可以从哪些入口接入
除了官方 API 直连,xAI 在 Grok 4.6 发布公告中列明了多个官方合作渠道,不同入口适合不同场景:
- 官方 API(开发者首选):控制台 console.x.ai 创建 Key,调用地址 https://api.x.ai/v1,文档见 https://docs.x.ai 定价页见 docs.x.ai/docs/pricing。按 token 用量付费,无月最低消费。
- Grok Build 与 Cursor:官方自家编程IDE 与代码编辑器,适合直接当 AI 编程工具用,Grok 4.6 上线首周官方给过双倍用量促销。
- 云市场与网关:Grok 4.6 已上架 Amazon Bedrock、Microsoft Foundry,并通过 OpenRouter、Vercel、Cloudflare 等合作伙伴分发——对已经在这些平台上做多模型路由的团队最省事。
注意区分:X 平台的 Grok 聊天窗口、X Premium 订阅与开发者 API 是三套计费体系,买了 X Premium 不等于拿到了 API 额度。
grok api key 怎么获取
- 在控制台 Settings → API Keys 创建新密钥。Key 通常以 xai- 开头,生成后立即复制保存。
- 把 Key 放进服务端环境变量,不要写进前端代码或提交到 Git 仓库:
接入前还需要绑定支付方式:官方按实际用量扣费,付费账户才有稳定的速率额度。
grok api 怎么调用:OpenAI 兼容写法
这是接入的核心:xAI 的 API 完全兼容 OpenAI 协议,不需要安装任何专用 SDK,改一行 base_url 即可复用现有代码(工具调用、结构化输出、流式、视觉输入全部走同一套 SDK)。
Python 示例:
等价的 curl 写法:
几个常用能力:多轮对话直接用 OpenAI 的 messages 结构;推理强度可通过 reasoning effort 参数配置(Grok 4.6 支持 low / medium / high / xhigh,4.5 支持 low / medium / high),长任务建议显式指定以免按默认值(high)扣费;联网与 X 搜索属于服务端工具,按调用次数额外计费,不需要自己写 function schema。
grok 模型清单与价格对照
下表按官方定价页与 xAI 官方公告整理(核查时间 2026 年 9 月 9 日,单位美元/百万 tokens)。xAI 采用双列定价,区分短上下文与长上下文:
| | | | |
|---|
grok-4.6(当前旗舰,2026-08-12 发布) | | | | |
| | | | |
| | | | |
grok-4.20(reasoning / non-reasoning / multi-agent) | | | | |
| | | | |
选型建议:追求最强智能体能力选 grok-4.6(官方定位长程 Agent、编程与视觉交互);要 1M 长上下文且单价更低,选 grok-4.3;纯编程任务可用 grok-build-0.1,它在四个模型里输出最便宜。注意 grok-4.6 还有一个 fast 变体,价格为标准版的 2 倍。
grok api 的计费细节与 200k 价格悬崖
- 200k 阈值是整请求重算,不是分段累加:官方定价规则规定,一旦请求超过模型的长上下文阈值(200k tokens),该请求的每一个 token 都按长上下文单价重算,而不仅是超出部分。一个 210k token 的请求,比两个 105k 的请求贵得多。
- 缓存很划算:重复的系统提示/文档前缀走缓存,4.3 系列缓存读取价 0.20 对正常输入 1.25,折扣约 84%;Agent 循环里长任务收益最大。
- 服务端工具单独收费:Web Search、X Search、Code Execution 按每 1000 次调用 5 美元计;Collections Search 为 2.5 美元/千次;文件附件处理为 10 美元/千次。开了联网搜索的请求,token 费之外还有这份账单。
- 批处理与加急:Batch 模式有 20% 折扣,但只对 grok-4.3 与 grok-4.20 系列生效,旗舰 grok-4.6/4.5 不参与;Priority Processing(优先处理)按标准价 2 倍计费。
- 老模型已退役但会重定向:Grok 4.1 Fast、Grok 4 Fast、Grok 4、Grok 3 等已于 2026 年 5 月 15 日退役,其 slug 会重定向到 grok-4.3——老代码不会报错,但会按 1.25/2.50 的费率扣款,而不是开发者记忆里 0.30/0.50 的低价。这是最隐蔽的一类"账单刺客"。
grok api 常见报错与排查
| | |
|---|
| Key 无效/过期,或 base_url 仍指向 OpenAI | 确认请求头为 Bearer xai-...,base_url 必须是 https://api.x.ai/v1 |
| | 用 GET /v1/models 拉取当前可用模型列表再调用 |
| | |
| | |
| 请求超过 200k 触发整请求高价,或开了付费服务端工具 | |
国内团队若直接调用海外端点不通,可走官方列出的合作渠道(OpenRouter、Vercel、Cloudflare、Amazon Bedrock、Microsoft Foundry 等),或选用提供 OpenAI 兼容端点的第三方聚合平台;这些路径的接入写法与本文一致,只需替换 base_url 与 Key。
grok api 接入要注意什么
- 旗舰换代很快:Grok 4.5 于 2026 年 7 月发布、Grok 4.6 紧接着 8 月 12 日接棒为旗舰,官方模型总览页也会随之跳转。写死模型名的代码建议做定期核对,别让业务挂在上代模型上。
- 公司实体已更名:官方新闻与文档中已出现 SpaceXAI 名称(此前为 xAI),涉及企业采购、合同与发票时请核实签约主体。
- 地区与支付限制:这是海外付费 API,账户支付、网络可达性与合规要求需自行确认;内网/受控环境下优先走已接入 Grok 的云平台渠道。
- 不要把 Key 放进浏览器端:任何放前端的 Key 都等于公开泄露,务必走服务端代理。
- 数据合规:涉及个人信息、涉密或未公开代码库时,评估数据跨境与留存条款后再决定是否调用。
grok api 接入常见问题
Q:grok api 免费吗?
A:注册后是否有额度以控制台为准;历史上官方出现过数据贡献换额度的活动,但这类政策变动频繁,接入前请以 console.x.ai 账单页的实际显示为准。
Q:必须用 xAI 自己的 SDK 吗?
A:不用。Grok API 完全兼容 OpenAI 协议,用官方 openai 包改 base_url 即可,也可直接用 HTTP 请求。
Q:base_url 到底填什么?
A:https://api.x.ai/v1。许多人报错的根因就是忘了改这里,请求仍发往 OpenAI。
Q:现在该用哪个模型?
A:默认用 grok-4.6(当前旗舰,编程与长程 Agent);要更长上下文或更低单价用 grok-4.3(1M 上下文、1.25/2.50);编程任务也可试 grok-build-0.1。
Q:老代码里的 grok-3 还能用吗?
A:模型已于 2026 年 5 月 15 日退役,slug 重定向到 grok-4.3,请求不会失败但按新价计费,建议尽快迁移。
Q:为什么一次调用贵得离谱?
A:八成是跨过了 200k token 阈值,整请求按长上下文单价重算;也可能开了联网搜索、代码执行等按次计费的服务端工具。
Q:支持视觉和图片理解吗?
A:旗舰系列支持图像输入,可直接传图参与对话;具体支持矩阵以官方模型页为准。
Q:国内直连不通怎么办?
A:官方已把 Grok 上架 Amazon Bedrock、Microsoft Foundry,并通过 OpenRouter、Vercel、Cloudflare 等合作方分发;也可选提供 OpenAI 兼容端点的第三方聚合平台,写法不变。
Q:怎么控制推理成本?
A:显式指定 reasoning effort(low/medium/high/xhigh),简单任务别用 high 及以上;长上下文低于 200k 拆批处理;Batch 模式(仅 4.3/4.20 系列)可再省 20%。
文中xAI 的旗舰模型、价格体系与模型退役政策更新频繁(近半年内已发生多次),实际接入请以 console.x.ai 与 docs.x.ai 官方文档最新公布为准。第三方数据已注明来源与时间。